Release Notes

Die Funktionalität „Tailored UI“ ermöglicht das projektspezifische Anordnen, Ausblenden, Deaktivieren von Funktionen im ContentCreator. Auf diese Weise kann die Oberfläche des ContentCreator komfortabel an die Erfordernisse des Projekts und der Redakteurinnen angepasst werden.
Bisher erfolgte die Konfiguration über das Systemmodul „FirstSpirit CXT ContentCreator Extension“.

Für eine einfachere Verwendung und Konfiguration in der Cloud wurde die Funktionalität des Moduls mit dem aktuellen Release in den ContentCreator integriert.
Somit erfolgt die Konfiguration jetzt nicht mehr über die Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“, sondern über die Projekt-Komponente „CXT ContentCreator: Feature Configuration ProjectApp“:

(FirstSpirit ServerManager / Projekteigenschaften / Projekt-Komponenten)

War die Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ in Projekten bereits hinzugefügt, wird mit dem Update auf das aktuelle FirstSpirit-Release automatisch die neue Projekt-Komponente „CXT ContentCreator: Feature Configuration ProjectApp“ verwendet. Auch bestehende Konfiguration wird beim Update automatisch migriert: Es sind keine manuellen Anpassungen erforderlich.

In Projekten, in denen die Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ vor dem Update auf das aktuelle FirstSpirit-Release noch nicht vorhanden war, muss mit dem aktuellen Release die neue Projekt-Komponente „CXT ContentCreator: Feature Configuration ProjectApp“ manuell dem gewünschten Projekt hinzugefügt werden, um die Funktionalität „Tailored UI“ nutzen zu können.

Beim Update auf das aktuelle FirstSpirit-Release wird das jetzt nicht mehr benötigte Systemmodul „FirstSpirit CXT ContentCreator Extension“ automatisch deinstalliert.

Mit dem Systemmodul „FirstSpirit CXT ContentCreator Extension“ ist in diesem Zusammenhang auch die Web-Komponente „CXT ContentCreator Extension: WebApp for ContentCreator“ entfallen.

Zu weiteren Informationen siehe auch https://docs.e-spirit.com/odfs/vorlagenentwick/contentcreator/customization/standardfunktio/index.html.

FirstSpirit bietet mehrere Möglichkeiten, mit denen URLs ganz nach Bedarf generiert werden können.

Speziell der mitgelieferte „Advanced URL Creator“ legt bei der Erzeugung von URLs die Anzeigenamen von FirstSpirit-Objekten zugrunde. Mit dem aktuellen FirstSpirit-Release können projektspezifische Konvertierungsregeln für Zeichenersetzungen definiert werden. Anhand dieser Regel erfolgt bei einer Generierung dann eine Umformung, z. B.

• ä => ae
• Ä => Ae
• & => und

Dazu steht jetzt die neue Projekt-Komponente „FirstSpirit AdvancedUrlFactory Configuration“ zur Verfügung (FirstSpirit ServerManager / Projekteigenschaften / Projekt-Komponenten):

In bestehenden Projekten muss diese Projekt-Komponente manuell hinzugefügt werden, in neuen Projekten ist die Projekt-Komponente automatisch enthalten.

Über diese Projekt-Komponente kann entweder

• eine der serverweit gültigen Konvertierungsregeln ausgewählt werden oder
• eine projektspezifische Konvertierungsregel definiert werden.

1. Serverweit gültige Konvertierungsregeln werden im FirstSpirit ServerManager unter Server-Eigenschaften / Konvertierungs-Regeln definiert.
Die gewünschte Regel kann aus der Klappbox „Konvertierungs-Regel“ ausgewählt werden. Im Feld „Definition“ wird die Definition dargestellt. Diese kann hier nicht bearbeitet werden.

2. Eine projektspezifische Konvertierungsregel kann definiert werden, wenn in der Klappbox „Konvertierungs-Regel“ -CUSTOM- ausgewählt ist.
Jede Regel muss in einer Zeile stehen und besteht aus zwei Werten, die durch ein Gleichheitszeichen getrennt werden:

• links das Sonderzeichen, das umgeformt werden soll, entweder direkt per Tastatur eingegeben oder als Hexadezimalcode (z. B. 0xe4 für ae).
• rechts das oder die gültige/n Zeichen, in das das Sonderzeichen bei der Verwendung des Advanced URL Creator umgeformt werden soll, in doppelten Hochkommata.

Hinweis: Gleichheitszeichen (0x3D), Leerzeichen (0xa0) und einige Steuerzeichen müssen zwingend in Hexadezimalcode angegeben werden.

Beispiel:

[convert]
Ä="Ae"
Ö="Oe"
Ü="Ue"
ä="ae"
ö="oe"
ü="ue"
ß="ss"

Hinweis: Das Ändern der Regel von -CUSTOM- auf eine andere setzt die Regel -CUSTOM- zurück und überschreibt diese. Nicht-Cloud-Kunden wird die Verwendung einer serverweit gültigen Regel empfohlen.

Ein Zurücksetzen ist über das Speichern eine leeren -CUSTOM--Regel möglich.

Im Rahmen dieses Features zur Umformung von Zeichen in Generierungen wurde darüber hinaus allgemein das Konfigurationsformat von Konvertierungsregeln geändert: Konnte das zu ersetzende Zeichen bisher ausschließlich per hexadezimalem Unicode-Wert eingegeben werden, können mit dem aktuellen Release die zu ersetzenden Zeichen überwiegend direkt per Tastatur eingegeben werden.
Hinweis: Gleichheitszeichen (0x3D), Leerzeichen (0xa0) und einige Steuerzeichen müssen weiterhin zwingend in Hexadezimalcode angegeben werden.

Zu weiteren Informationen siehe:

• Advanced URLs: https://docs.e-spirit.com/odfs/weiterfuehrende/generierung/advanced-urls/index.html
• Serverweite Konvertierungsregeln: https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/server-eigensch/konvertierungs/index.html
• Konvertierung in Formatvorlagen: https://docs.e-spirit.com/odfs/vorlagen-grundl/aufbau-vorlagen/formatvorlagen/konvertierung/index.html

Das Ausführen von Aufträgen, z. B. Generierungen, Backups usw., kann zu einer hohen Last auf dem Server führen und so für Performanz-Probleme sorgen.

In der Regel werden Aufträge aufgrund von festgelegten Zeitplänen automatisch gestartet.
Mit dem aktuellen Release wird jetzt die Anzahl an gleichzeitig gestarteten Aufträgen standardmäßig beschränkt:

Backups
Dazu zählen sowohl Aufträge vom Typ „Projektsicherung durchführen“ als auch „Enterprise Backup“-Aufträge.
Standardmäßig können jetzt maximal 4 solcher Aufträge zeitgleich ausgeführt werden.

Hinweis: Manuell gestartete Projekt-Exporte sind von dieser Einstellung nicht betroffen und werden weiterhin sofort ausgeführt („FirstSpirit ServerManager / Projekt / Exportieren“).

Generierungen
Standardmäßig können jetzt maximal 10 solcher Aufträge zeitgleich ausgeführt werden.

Andere Auftragstypen
werden, wie bisher, über die sogenannte „Default Thread Queue“ ausgeführt. Dabei handelt es sich um eine allgemeine Ausführungs-Queue, die nicht auf Aufträge beschränkt ist.
Die Anzahl der Aufträge, die in dieser Queue gleichzeitig ausgeführt werden dürfen, beträgt standardmäßig die Anzahl der Kerne * 6.
(Siehe dazu https://docs.e-spirit.com/odfs/edocs/admi/konfiguration-f/konfigurationsd/firstspirit-ser/bereich-thread/index-2.html.)

Ist die maximal erlaubte Zahl an gleichzeitig laufenden Aufträgen erreicht, werden darüber hinaus gehende Aufträge in eine Queue eingereiht und erst ausgeführt, wenn die erlaubte Zahl gleichzeitig laufender Aufträge wieder unterschritten ist.

Konfiguration
Mit den folgenden Parametern kann definiert werden, wie viele Aufträge gleichzeitig ausgeführt werden dürfen. Dabei können jeweils eine eigene Queue für

• Backup-Aufträge (backupQueue)
• Generierungsaufträge (generateQueue)
• alle anderen Auftragstypen (defaultQueue)

konfiguriert werden.

• Die maxRunning-Parameter beschränken die gleichzeitige Ausführung des betreffenden Auftragstyps. Werden darüber hinaus gehende Aufträge gestartet, werden sie in eine Queue eingereiht und erst ausgeführt, wenn die Anzahl der laufenden Aufträge den maxRunning-Wert unterschreitet.
  Wird maxRunning auf -1 gesetzt, wird die allgemeine „Default Thread Queue“ verwendet.
• Werden für die Parameter keine expliziten Werte angegeben (leer), wird der Wert der allgemeinen „Default Thread Queue“ verwendet.

schedule.generateQueue.maxRunning: Gibt an, wie viele Generierungsaufträge gleichzeitig ausgeführt werden dürfen.
Standardwert ist 10

schedule.generateQueue.queueCapacity: Gibt an, wie viele Generierungsaufträge maximal in die Queue aufgenommen werden.
Standardwert ist leer.

schedule.backupQueue.maxRunning: Gibt an, wie viele Backup-Aufträge gleichzeitig ausgeführt werden dürfen.
Standardwert ist 4.

schedule.backupQueue.queueCapacity: Gibt an, wie viele Backup-Aufträge maximal in die Queue aufgenommen werden.
Standardwert ist 128.

schedule.defaultQueue.maxRunning: Gibt an, wie viele Aufträge dieser Queue gleichzeitig ausgeführt werden dürfen.
Standardwert ist -1 (also: Es wird die „Default Thread Queue“ verwendet).

schedule.defaultQueue.queueCapacity: Gibt an, wie viele Aufträge maximal in diese Queue aufgenommen werden.
Standardwert ist leer.

Zu weiteren Informationen siehe

• Auftragsplanung: https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/auftragsplanung/index.html
• Konfiguration der Queues: https://docs.e-spirit.com/odfs/edocs/admi/konfiguration-f/konfigurationsd/firstspirit-ser/bereich-server/index.html
• Default Thread Queue: https://docs.e-spirit.com/odfs/edocs/admi/konfiguration-f/konfigurationsd/firstspirit-ser/bereich-thread/index-2.html

Sind für Projekte sehr viele Auflösungen für Bilder definiert, kann eine Generierung neuer Bilder zu einer sehr hohen Serverlast und großem Speicherbedarf führen.

Mit dem aktuellen Release können Auflösungen mit Tags versehen werden, um bei der „Medien-Generierung“ bzw. bei der JSON-Ausgabe von Mediendaten die Anzahl der zu generierenden Auflösungen einzuschränken.
Auf diese Tags kann dann in Generierungsaufträgen per Variable und per API zugegriffen werden.

Die Tags werden in der Auflösungstabelle dargestellt:

(FirstSpirit ServerManager / Projekteigenschaften / Auflösungen)

Die Tags können für die gewünschten Auflösungen durch Anklicken aktiviert bzw. deaktiviert werden.
Neue Tags können über die Schaltfläche „Tags hinzufügen“ erstellt werden. Diese werden allen vorhandenen Auflösungen hinzugefügt. Um eine Auflösung mit dem neuen Tag zu versehen („taggen“), muss es in der Tabelle für die gewünschte Auflösung aktiviert werden.

Auswertung in der Generierung
Um in einer Medien-Generierung nur die Auflösungen zu erzeugen, für die ein oder mehrere Tags aktiviert ist, verwenden Sie die Variable

media_resolution_tags

Und zwar im Auftrag „Generierung ausführen“, auf dem Register „Erweitert“ im Bereich „Variablen“:

(FirstSpirit ServerManager / Projekteigenschaften / Auftragsverwaltung)

Mehrere Tags können durch Komma separiert angegeben werden.
Die Variable wird berücksichtigt, wenn der Startpunkt der Generierung in der Medien-Verwaltung liegt (Register „Eigenschaften“, „Teilgenerierung durchführen für folgende Startpunkte“).
Wird die Variable nicht angegeben, wird die Generierung nicht eingeschränkt.

Auch in der JSON-Ausgabe wird die Variable media_resolution_tags ausgelesen. Sie kann dafür im Auftrag, in den entsprechenden Vorlagen oder per API über die Methode additionalContext(); des Interface RenderingAgent.Renderer (FirstSpirit Developer-API, Package de.espirit.firstspirit.agency) gesetzt werden.

Zugriff über die API
Über die neuen Methoden getTags(); und setTags(); (FirstSpirit Access-API, Interface Resolution, Package de.espirit.firstspirit.access.project) können die Tags einer Auflösung per API ermittelt bzw. neue hinzugefügt werden, z. B.

resolution.getTags();

Über die neue Methode getResolutionsByTag (FirstSpirit Developer-API, Interface ResolutionAgent , Package de.espirit.firstspirit.agency) können die Auflösungen ermittelt werden, für die ein oder mehrere Tags aktiviert ist, z. B.

getResolutionsByTag("SmartCropping");

Ob für eine Auflösung das Tag SmartCropping gesetzt ist, kann über die Methode isSmartCropping() im Interface Resolution (FirstSpirit Access-API, Package de.espirit.firstspirit.access.project) ermittelt werden.

Tags bearbeiten

Vorhandene Tags können in der Auflösungstabelle per Kontextmenü umbenannt oder entfernt werden:
Tag umbenennen: Mithilfe dieser Funktion kann das gewählte Tag für alle Auflösungen umbenannt werden.
Ausnahme: Das System-Tag SmartCropping kann nicht umbenannt werden.

Tag entfernen: Mithilfe dieser Funktion kann das gewählte Tag aus allen Auflösungen entfernt werden.
Ausnahme: Das System-Tag SmartCropping kann nicht entfernt werden.

System-Tag SmartCropping
Standardmäßig ist für neue Auflösungen das System-Tag SmartCropping vergeben.
Das Tag sorgt dafür, dass die „SmartCropping“-Funktionalität im ContentCreator für die betreffende Auflösung verwendet wird.
Soll die „SmartCropping“-Funktionalität für eine neu angelegte Auflösung nicht verwendet werden, entfernen Sie das Tag aus dem Feld. Geben Sie bei Bedarf andere Tags ein oder lassen Sie das Feld leer.

Zu weiteren Informationen siehe

• Auflösungen:
  https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/projekteigensch/aufloesungen/index.html
• Generierungsauftrag:
  https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/auftragsplanung/projektbezogene/generierung-aus/index.html

Mit dem aktuellen FirstSpirit-Release wird jetzt bei einer Generierung auch die Anzahl der generierten Medien und der skalierten Bilder sowie deren Dateigröße im Log festgehalten, z. B.

INFO  20.07.2021 10:43:43.092 {uID=0,seID=1258682,pID=1249405} (de.espirit.firstspirit.
   server.scheduler.GenerateTaskExecutor): 1929 media files produced, 72,171 MB of 
   media data copied, 833 scaled pictures with a total of 4,571 MB created, ~31 ms 
   per scaled picture, 0:00:26.648 total picture scaling time

Auf diese Weise lässt sich die Last eines Auftrages besser beurteilen.

Zu informationen zu Generierungsaufträgen siehe auch https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/auftragsplanung/projektbezogene/generierung-aus/index.html.

Das Verhalten beim Starten von Diensten wurde verbessert: Kann ein Dienst nicht innerhalb von drei Minuten gestartet werden, wird der Start-Versuch abgebrochen, so dass anschließend gegebenenfalls weitere Dienste gestartet werden können.

Das Zeitintervall (in Sekunden) kann in der Konfigurationsdatei fs-server.conf eingestellt werden, über den Parameter services.start.timeout.

Siehe auch https://docs.e-spirit.com/odfs/edocs/admi/konfiguration-f/konfigurationsd/firstspirit-ser/bereich-misc/index.html.

With the upcoming release (2021-09), new FirstSpirit releases will be published every 4 weeks, instead of once a month as before.

We will continue to inform you about new releases in the FirstSpirit Community (https://community.e-spirit.com), in the „Customers“ section.
FirstSpirit instances of cloud customers are automatically updated to the latest release on a regular basis (as part of the so-called „Patch Days“).

FirstSpirit bietet die Möglichkeit, stark strukturierte Inhalte in einer Datenbank zu verwalten. Dies können beispielsweise Produktkataloge oder Adresslisten sein. Die Verwaltung solcher Inhalte in Datenbanken (als „Datensätze“) ermöglicht unter anderem effiziente und komplexe Suchanfragen nach diesen Daten im Client und eine (automatisch) gefilterte Ausgabe auf der Website. Sie können übersichtlich in Tabellen dargestellt werden und Datensätze lassen sich gut an den unterschiedlichsten Stellen wiederverwenden.
Datensätze, die auf einer Datenstruktur bestehen und die gleichen EIngabekomponenten zur Aufnahme und Speicherung der Daten verwenden, werden in FirstSpirit in so genannten „Datenquellen“ verwaltet. Datensätze einer Datenquelle „Adressliste“ umfassen so beispielsweise Daten zu Vor-, Nachname, Telefonnummer, E-Mail-Adresse und Bild, während eine Datenquelle „Produktkatalog“ Daten zu Produktname, Beschreibung, Eigenschaften wie Größe, Gewicht usw. umfasst.

Typ-Symbol für Datenquellen

Bisher war das Anlegen und Bearbeiten von Datensätzen besonders einfach im FirstSpirit SiteArchitect zu erledigen, der FirstSpirit ContentCreator sah nur eine grundlegende Bearbeitung von Datensatz-Inhalten vor.
Mit dem aktuellen Release stellt jetzt auch der ContentCreator eine übersichtliche Darstellung von Datensätzen bereit. In dieser Ansicht können Datensätze komfortabel erstellt und bearbeitet werden.

Eine offizielle Freigabe der Funktionalität ist für eines der kommenden Releases geplant. In diesem Rahmen wird auch die Ergänzung der Dokumentation für Administratoren und Redakteure erfolgen.

Aktivierung und Konfiguration
Standardmäßig ist die Funktionalität im ContentCreator inaktiv. Sie ist Teil der „Tailored UI“. Um sie nutzen zu können, muss sie über den FirstSpirit ServerManager aktiviert werden:

• Wenn nicht bereits vorhanden: Hinzufügen der Projekt-Komponente „CXT ContentCreator: Feature Configuration ProjectApp“ zum gewünschten Projekt (FirstSpirit ServerManager / Projekteigenschaften / Projekt-Komponenten)
• Die Datenquellen-Darstellung und -Bearbeitung können über die so genannten „Features“ konfiguriert werden ( DOPPELKLICK oder Schaltfläche „Konfigurieren“ auf der Projekt-Komponente).
  Die Features gehören der Gruppe EntityManagement an:

Die Standardeinstellung für das Feature EntityManagement: enabled ist aktuell Unavailable. Um die Funktionen nutzen zu können, muss für dieses Feature die Verfügbarkeit Available konfiguriert werden. Die andere Features der Gruppe EntityManagement sind dann ebenfalls Available, sie müssen nicht explizit aktiviert werden.

Darstellung und Verwendung im ContentCreator
Ist die Funktion EntityManagement: Enabled aktiviert (Available), kann die Datenquellen-Ansicht im entsprechenden Projekt über das entsprechende Icon in der Menüleiste geöffnet werden:

Die Datenquellen-Ansicht ist grundsätzlich wie die Medien-Verwaltung aufgebaut:

• Links befindet sich die Baumstruktur mit den im Projekt vorhandenen Datenquellen. Diese können je nach Projektkonfiguration in Ordnern strukturiert sein.
  Hier können Lesezeichen gesetzt werden.
• Im Hauptbereich werden die Datenquellen und Datensätze angezeigt.
  Neben den bisher bekannten Darstellungmodi gibt es jetzt zusätzlich die Optionen „Tabelle“ und „Kachel“:

Tabellendarstellung
Die Darstellung der Datenquelle als Tabelle wird durch das Mapping der entsprechenden Tabellenvorlage bestimmt. Über das Mapping kann z. B. konfiguriert werden, ob eine Spalte ausgeblendet werden soll (Option „Anzeigen“).
Durch das Ausblenden einer oder mehrerer Spalten kann speziell bei großen Datenmengen die Performance verbessert werden.
Sortierbar sind Spalten einfacher Datentypen (auf- und abwärts, beispielsweise alphabetisch oder numerisch).

Die Spalte, nach der aktuell sortiert wird, ist blau markiert.
Die Standardsortierung wird durch die verwendete Datenbank vorgegeben.
Die Sortierung gilt immer nur für eine Session und einer Benutzer.
Spalten vom Typ FS_INDEX werden hier nur dann angezeigt, wenn sie das DatasetDataAccessPlugin verwenden.

Suche
Die Datenquellen-Suche oberhalb der Baumstruktur ermöglicht eine Volltextsuche über alle Datenquellen.
Die Suche startet direkt mit der Eingabe von Zeichen in das Suchfeld.
Hinter den Datenquellen-/Ordnern wird die Anzahl der Suchtreffer angezeigt.

Ein Datensatz kann in mehreren Datenquellen vorhanden sein, beispielsweise wenn es sich um eine „gefilterte“ Datenquelle handelt (wird im FirstSpirit SiteArchitect konfiguriert).
In diesem Fall wird neben der Datenquelle ein numerischer Bereich angezeigt, z. B. Produkt (0-11). Das bedeutet, dass in der betreffenden Datenquelle bis zu 11 Suchtreffer enthalten sind.
Wird eine Datenquelle direkt gewählt, werden die Datensätze mit Suchtreffern angezeigt.

Aktionen

• Lesezeichen setzen
  Sowohl für Datensätze als auch Datenquellen und Datenquellen-Ordner können Lesezeichen gesetzt werden.
• Datensatz löschen
  Das Löschen von Datensätzen erfolgt über einen zu konfigurierenden Arbeitsablauf.
• Vorschau anzeigen
  Um zu prüfen, wie der Datensatz auf einer Seite konkret dargestellt (auch: „gerendert“) wird, kann mit einem Klick auf dieses Icon zu einer entsprechenden Seite gewechselt werden.
  Voraussetzung: Für die betreffende Tabellenvorlage muss auf dem Register „Eigenschaften“ im Feld „Vorschauseite“ eine Seite eingestellt sein, auf der der Datensatz tatsächlich „gerendert“ wird.
• Datensatz kopieren
  Bestehende Datensätze können kopiert werden.
• Datensatz bearbeiten
  Öffnet ein Bearbeitungsfenster mit allen Eingabeelementen des ausgewählten Datensatzes.

Neue Datensätze können weiterhin über das +-Icon in der Menüleiste angelegt werden.
Ist aktuell eine Datenquelle ausgewählt, wird diese im Menü zuoberst angezeigt. Damit lassen sich direkt neue Datensätze in dieser Datenquelle anlegen.
Darüber hinaus werden in dem Menü wie bisher nur die Datenquellen zur Auswahl angeboten, für die eine Vorschauseite ausgewählt ist und für die die Option „Im ContentCreator verwendbar“ aktiviert ist (beides in der entsprechenden Tabellenvorlage, Register „Eigenschaften“).

Status und Arbeitsabläufe
An jedem Datensatz wird der jeweilige Arbeitsablauf-Status visualisiert.
Die Datensätze lassen sich (über „Alle Inhalte“) nach Status filtern.

Um einen Arbeitsablauf auf Datensätzen, Datenquellen oder Ordnern zu starten oder weiterzuschalten, können diese per Klick ausgewählt werden (Mehrfachauswahl innerhalb einer Datenquelle oder eines Ordners mit Strg oder Umschalt ).
Im Dashboard kann der gewünschte Arbeitsablauf dann gestartet bzw. weitergeschaltet werden.
Dabei ist zu beachten, dass sich der Arbeitsablauf, der über die Statusanzeige (auch „Element-Status“, in der Menüleiste) geschaltet werden kann, immer auf das übergeordnete Element bezieht.

Datensätze in Reports

• Befindet man sich in der Vorschau (z. B. einer Seite), wird mit einem Klick auf einen Datensatz in Reports eine Seite angezeigt, auf der der Datensatz konkret gerendert wird.
  Voraussetzung: Für die betreffende Tabellenvorlage muss auf dem Register „Eigenschaften“ im Feld „Vorschauseite“ eine Seite eingestellt sein, auf der der Datensatz tatsächlich „gerendert“ wird.
• Ansonsten (außerhalb der Vorschau) wird der Datensatz in der Datenquellen-Ansicht geöffnet und in der betreffenden Datenquelle gehighlighted.
  Von dort kann bei Bedarf über das Icon „Vorschau anzeigen“ zum Datensatz in der Vorschau gewechselt werden.

Weiterführende Informationen

• Konzept von Datensätzen:
  • https://docs.e-spirit.com/contentcreator/vorschauseite-b/bedienkonzept/index.html#datensaetze
  • https://docs.e-spirit.com/contentcreator/vorschauseite-b/datensaetze/index.html
• Vorlagenentwicklung für Datenbank-Inhalte:
  • https://docs.e-spirit.com/odfs/vorlagen-grundl/aufbau-vorlagen/datenbank-schem/index.html
• „Tailored UI“:
  • https://docs.e-spirit.com/odfs/vorlagenentwick/contentcreator/customization/standardfunktio/index.html
• Darstellung und Funktionsweise der Medien-Verwaltung:
  • https://docs.e-spirit.com/contentcreator/menuefunktionen/medien-verwaltu/index.html

Bilder sind wichtig für jede Internetpräsenz, um Inhalte anschaulich und emotional vermitteln zu können.
Das Konzept der „Bild-Auflösungen“ in FirstSpirit ermöglicht dabei seit jeher eine einheitliche Verwendung von Bildgrößen in Online-Präsenzen. Die für ein Projekt gewünschten Auflösungen werden vom System standardmäßig automatisch berechnet und erzeugt.
Je nach Bildmaterial und Projekteinstellungen müssen diese automatisch erzeugten Auflösungen jedoch oftmals vom Redakteur geprüft und manuell angepasst werden: In manchen Projekt-Set-Ups (z. B. bei einer Vorgabe von konkreten Seitenlängen) sind die Auflösungen gestaucht, die Proportionen des angelieferten Bildmaterials passen nicht zu den Proportionen und Größen, die für die Internetpräsenz benötigt werden. In anderen Fällen soll in den vorliegenden Bildern ein spezieller Fokus gewählt werden, um so einen bestimmten Ausschnitt in den „Mittelpunkt“ zu rücken.

Das Modul „FirstSpirit Image Recognition“ integriert eine KI-unterstützte Bilderkennung in die Redaktionsprozesse, so dass Gesichter, Objekte und Texte auf Bildern automatisch erkannt werden können: Beim Upload im ContentCreator werden Bilder mit passenden Daten angereichert und auf Wunsch direkt automatisch zugeschnitten.

Mit dem aktuellen FirstSpirit-Release wird die Verwendung des Moduls „FirstSpirit Image Recognition“ offiziell freigegeben.

• Cloud-Kunden müssen die Funktionalität für das oder die gewünschten Projekte aktivieren.
  Je nach gewünschter Ausprägung muss eine entsprechende Option im FirstSpirit ServerManager aktiviert werden und / oder die Metadaten-Vorlage des Projekts angepasst werden.
• Kunden, die FirstSpirit selbst betreiben und warten, müssen zuvor das Modul installieren: imagerecognition-module-[version].fsm. Es kann über den Technical Support angefordert werden.
  Voraussetzung: Das Modul nutzt für die Bildanalyse den Bilderkennungsdienst „Amazon Rekognition“. Dazu muss ein Amazon-Konto mit Credentials vorliegen, das die Verwendung von „Amazon Rekognition“ und (optional) eines S3-Buckets erlaubt.

Zu weiteren Informationen siehe:

• Installation, Aktivierung und Vorlagenentwicklung: https://docs.e-spirit.com/odfs/vorlagenentwick/contentcreator/index.html
• Verwendung im ContentCreator: https://docs.e-spirit.com/contentcreator/vorschauseite-b/arbeiten-mit-di/bildausschnitt/index.html

Jedes Medium in FirstSpirit muss zwingend jeweils einen Dateinamen haben. Im Vergleich zum Anzeigenamen, der für jede Projektsprache individuell vergeben werden kann, ist der Dateiname eher technischer Natur. Ist für ein Medium kein Anzeigename vergeben, wird als Workaround an manchen Stellen der Dateiname verwendet.
Je nach Projektkonfiguration wird der Dateiname von Medien auch für die Erzeugung von URLs für Medien herangezogen.

Mit dem aktuellen FirstSpirit-Release können zusätzlich zu den Anzeigenamen von Medien auch deren Dateinamen geändert bzw. beim Anlegen manuell eingegeben werden, z. B.

Erlaubte Zeichen sind:
Buchstaben (Groß- und Kleinschreibung), Ziffern, Unterstriche, Minus-Zeichen

a-z 0-9 _ -

Der Dateiname von Medien ist immer sprachunabhängig, d.h. es gilt ein Dateiname für alle Sprachen eines Mediums.
Wird der Dateiname in verschiedenen Sprachansichten geändert, so wird beim Speichern immer der zuletzt in das Feld eingetragene Wert berücksichtigt.

Wird ein Medium sprachabhängig gemacht und ein Medium für die andere Sprache hochgeladen, so wird der Dateiname beibehalten.
Wird ein Medium durch eine andere Datei ersetzt, bleibt der Dateiname erhalten. Soll der Dateiname neu (anhand der neuen Datei) gebildet werden, kann dazu das Feld vor dem Hochladen geleert werden.

Beim gleichzeitigen Hochladen mehrerer Medien können weder Dateiname noch Anzeigename manuell vergeben werden: die Namen werden automatisch vom System auf der Basis der jeweiligen Dateinamen der hochgeladenen Dateien gebildet und zugewiesen. Bei Bedarf können die Datei- und Anzeigenamen später individuell für jedes Medien angepasst werden.

Ab Version 3.0.0 unterstützt FSDevTools jetzt neue Parameter für den Transport von Rechten:

--permissionMode

Mit diesem Parameter kann konfiguriert werden, ob

• Redaktionsrechte (Wert: STORE_ELEMENT)
• Arbeitsablaufrechte (Wert: WORKFLOW)
• beides (Wert: ALL) oder
• keine Rechte (Wert: NONE)

transportiert werden sollen.

Standardmäßig werden bei einem Export keine Rechte exportiert werden (NONE).

Beim Import werden standardmäßig die Rechte berücksichtigt, die zuvor exportiert wurden und beim Import erlaubt sind (ALL).

--updateExistingPermissions

Wird dieser Schalter beim Import gesetzt, werden bestehende Rechte im Ziel-Projekt überschrieben (Wert: true). Standardmäßig (wenn der Schalter nicht angegeben wurde), bleiben diese unverändert.

Informationen zu den Parametern sind auch über den Aufruf

fs-cli help <command>

verfügbar.

Kompatibilität: Ab der Version 3.0.0 erfordert FSDevTools FirstSpirit mindestens in Version 2021-07.
Außerdem orientiert sich die Version von FSDevTools ab sofort am „Semantic Versioning“ (Pattern: MAJOR.MINOR.PATCH; siehe dazu auch https://semver.org).

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2021-08 unterstützt. Die Versionierung orientiert sich ab sofort am „Semantic Versioning“ (Pattern: MAJOR.MINOR.PATCH; siehe dazu auch https://semver.org)

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

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.

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.

FirstSpirit unterstützt prinzipiell nur die letzte LTS (Long-Term-Support)-Version von OpenJDK und Oracle Java sowie die jeweils aktuell freigegebene Version von OpenJDK. Der Support von Java-Versionen unterhalb 11 ist bereits seit einiger Zeit abgekündigt. FirstSpirit-seitig wurden viele Maßnahmen ergriffen, um die Kompatibilität mit Java 11 (und höheren Versionen) sicherzustellen.
Mit dem aktuellen Release wurde als letzter Schritt das Byte-Code-Level von Java 8 auf Java 11 umgestellt. Damit sind alle Java-Versionen unterhalb Java 11 (LTS) mit FirstSpirit inkompatibel.

Das bedeutet, dass FirstSpirit nicht mehr mit Oracle Java < 11 bzw. OpenJDK < 11 lauffähig ist und seitens der e-Spirit AG keine Maßnahmen mehr zur Beseitigung von Fehlern oder Problemen ergriffen werden, die mit Java < 11 in Zusammenhang stehen.

Zu weiteren Informationen zu den jeweils von FirstSpirit unterstützten Java-Versionen siehe auch https://docs.e-spirit.com/odfs/edocs/admi/technische-vora/index.html#java__firstpirit.

Im Rahmen dieser Umstellung orientiert sich die Darstellung der API-Dokumentation jetzt auch an der der API-Dokumentation von Oracle, Version 11+ (https://docs.oracle.com/en/java/javase/11/docs/api/index.html): Diese bietet statt der Navigation über Menüs in Frames jetzt eine Suche, mit der Inhalte aufgefunden werden können. Dieses neue Design ist stärker am aktuellen HTML5-Standard ausgerichtet.

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

Bei der JSON-Ausgabe von Entities werden jetzt Referenzen auf den entsprechenden Datensatz ausgegeben. Mithilfe dieser Referenz kann dann der dazugehörige Datensatz ermittelt und entsprechend geladen werden, z. B.

{
   "fsType": "Entity",
   "entityType": "table",
   "identifier": "06ff8faa-dade-495d-b94b-e86733b1ebed"
}