Einführung / FirstSpirit ServerManager / Projekteigenschaften / Kompatibilität

Kompatibilität

Inhaltsverzeichnis

e-Spirit ist bestrebt, dass einzelne FirstSpirit-Versionen untereinander in hohem Maße kompatibel sind und Kunden höchstens bei einem Wechsel auf eine neuere Major-Version nur geringe Migrationsaufwände entstehen. Bei einem Wechsel innerhalb einer Major-Version sollen prinzipiell keine Migrationsaufwände entstehen.

Um trotzdem innerhalb einer Major-Version neue nutzbringende Funktionalitäten in FirstSpirit integrieren zu können, die ggf. auch einmal wesentlichere Auswirkungen auf die Benutzerführung und / oder Änderungen der Datenstruktur/-haltung haben können, die potenziell bei einem Versionswechsel zu Migrationsaufwänden führen, wurde der Bereich „Kompatibilität“ eingeführt.

Hier hat der Kunde die Möglichkeit, selbst zu entscheiden, ob er potenzielle Migrationsaufwände in Kauf nehmen möchte, um so in den Genuß neuer Funktionalität zu kommen, bzw. er kann den Zeitpunkt der Funktionsumstellung selbst bestimmen.

Wichtig Einstellungen in diesem Bereich beeinflussen das Systemverhalten. Die Veränderung einer Einstellung kann zu Datenverlust führen. Die Auswirkungen im Projekt sollten daher im Vorfeld auf einem Entwicklungs- oder Test-System sorgfältig geprüft und die entsprechende FirstSpirit Dokumentation konsultiert werden.

FS_CATALOG: Verschachtelung sprachabhängiger Eingabekomponenten

In früheren FirstSpirit-Versionen war es technisch möglich, FS_CATALOG und alle inneren Formulare sprachabhängig zu konfigurieren (entspricht useLanguages="yes", dies ist die Standardeinstellung für alle Eingabekomponenten-Typen). Dies führte allerdings häufig zu Problemen hinsichtlich Übersetzungsprozessen, der Bedienbarkeit („Usability“) der Eingabekomponenten für Redakteure allgemein, der Wartbarkeit in der Entwicklung und auch zu Performance-Beeinträchtigungen. Inhalte, die der Redakteur eingibt, können beispielsweise (speziell auch in Kombination mit einer Verwendung der Übersetzungshilfe) in verschachtelten sprachabhängigen FS_CATALOG-Konstrukten potenziell nicht ausgegeben (z. B. Generierung) oder nachträglich bearbeitet werden.

Empfohlen wird daher die Verwendung von sprachunabhängigen Komponenten innerhalb einer sprachabhängigen FS_CATALOG-Komponente. Als Folge davon mussten Absatzvorlagen, die innerhalb einer FS_CATALOG-Komponente genutzt werden sollen, potenziell doppelt angelegt werden, einmal sprachunabhängig (zur Verwendung in einer sprachabhängigen FS_CATALOG-Komponente) und einmal sprachabhängig (zur Verwendung in allen anderen Fällen).

Verfügbar ab FirstSpirit-Version 5.2R5 Für Projekte, die mit FirstSpirit-Version 5.2R5 oder höher neu erstellt werden, wird standardmäßig die Verwendung sprachabhängiger Eingabekomponenten auf Ebenen innerhalb einer sprachabhängigen FS_CATALOG-Komponente unterbunden. Sprachabhängige Eingabekomponenten in Vorlagen, die innerhalb einer ebenfalls sprachabhängigen FS_CATALOG-Komponente verwendet werden, werden von FirstSpirit automatisch als sprachunabhängig behandelt. Somit werden die Nachteile des alten Verhaltens ausgeräumt.

Wichtig Das alte Verhalten ist nicht empfohlen und wird in Zukunft wahrscheinlich nicht mehr unterstützt. Eine Migration wird empfohlen.

Für Projekte, die bei einem Upgrade des Servers von einer früheren Version auf FirstSpirit-Version 5.2R5 übernommen werden oder die per Projektimport von einem Server mit einer früheren Version von FirstSpirit auf einem Server mit FirstSpirit-Version 5.2R5 importiert werden, wird das alte Verhalten bis auf Weiteres weiterhin unterstützt.
Um Projekte aus früheren FirstSpirit-Versionen auf eine Verwendung des neuen Verhaltens vorzubereiten, bietet FirstSpirit zwei Kompatibilitätseinstellungen an, die eine schrittweise Migration ermöglichen.

Wichtig Die Datenhaltung zwischen altem und neuen Verhalten ist unterschiedlich. Werden in einem Projekt sprachabhängige Komponenten innerhalb einer sprachabhängigen FS_CATALOG-Komponente verwendet, müssen die Daten der FS_CATALOG-Komponente geprüft und ggf. gesichert bzw. angepasst werden, bevor das neue Verhalten projektweit verwendet werden kann. Ohne Prüfung und Sicherung kann ein Wechsel zu Datenverlust im Projekt führen: Sind bereits Inhalte in einer FS_CATALOG-Komponente bzw. in inneren Formularen dieser Komponente vorhanden, so werden nach dem Speichern der FS_CATALOG-Komponente die Inhalte in der Sprache beibehalten, die gerade vom Redakteur bearbeitet wurde (Fallback: Mastersprache); waren Inhalte in anderen Sprachen vorhanden, so entfallen diese.

Beide Kompatibilitätseinstellungen haben folgende Auswirkungen:

  • Kompatibilitätseinstellung „inaktiv“: In einer sprachabhängigen FS_CATALOG-Eingabekomponente werden innere Eingabekomponenten, die in der jeweiligen Vorlage als sprachabhängig konfiguriert sind, als sprachunabhängig behandelt (neues Verhalten).
  • Kompatibilitätseinstellung „aktiv“: In einer sprachabhängigen FS_CATALOG-Eingabekomponente werden innere Eingabekomponenten, die in der jeweiligen Vorlage als sprachabhängig konfiguriert sind, als sprachabhängig behandelt (altes Verhalten).

Die Kompatibilität für einzelne FS_CATALOG-Komponenten kann über einen Parameter (forbidPolyglotDataHierarchy) in Vorlagen abgeschaltet werden. Dies erlaubt die Anwendung des neuen Standardverhaltens für einzelne FS_CATALOG-Eingabekomponenten, während andere FS_CATALOG-Komponenten, für die dieser Parameter nicht gesetzt ist, weiterhin kompatibel zu früheren FirstSpirit-Versionen behandelt werden.

Entsprechen alle FS_CATALOG-Komponenten im Projekt dem neuen Verhalten, kann die Kompatibilitätseinstellung projektweit deaktiviert werden, und zwar im Bereich "FS_CATALOG: Verschachtelung sprachabhängiger Eingabekomponenten":

Zugelassen (Kompatibilitätseinstellung „aktiv“, "altes" Verhalten): Die Verwendung sprachabhängiger Eingabekomponenten innerhalb einer sprachabhängigen FS_CATALOG-Komponente wird erlaubt.    
Dies kann zu Problemen beim Datenzugriff führen (s.o.), diese Einstellung ist daher nicht empfohlen. Sie ist ausschließlich zur Sicherstellung der Abwärts-Kompatibilität zu älteren Projekten vorgesehen.  
Dies ist die Standardeinstellung für Projekte, die mit einer Version unterhalb von 5.2R5 erstellt wurden. Um zur empfohlenen Einstellung „Unterbunden“ (s.u.) zu wechseln, kann dies mit einem Klick auf die Schaltfläche Unterbinden erreicht werden.

Unterbunden (Kompatibilitätseinstellung „inaktiv“, „neues“ Verhalten): Mit dieser Option wird projektweit für sprachabhängige Eingabekomponenten innerhalb einer sprachabhängigen FS_CATALOG-Komponente eine einsprachige Pflege erzwungen. Innere Vorlagen werden automatisch als sprachunabhängig (useLanguages="no") interpretiert. Inhalte in inneren Eingabekomponenten können dann nur noch einsprachig eingegeben und gespeichert werden.                                    
Dies ist die Standardeinstellung für Projekte, die mit einer FirstSpirit-Version 5.2R5 und höher erstellt wurden. Diese Einstellung wird empfohlen.

Wichtig Auch wenn ein Wechsel zu "Unterbunden" empfohlen wird, kann dieser zu einem Datenverlust im Projekt führen: Sind bereits Inhalte in einer FS_CATALOG-Komponente bzw. in inneren Formularen dieser Komponente vorhanden, werden nach dem Speichern der FS_CATALOG-Komponente die Inhalte in der Sprache beibehalten, die gerade vom Redakteur bearbeitet wurde (Fallback: Mastersprache), waren Inhalte in anderen Sprachen vorhanden, entfallen diese. Die Auswirkungen im Projekt sollten daher im Vorfeld sorgfältig geprüft und potenziell entfallende Inhalte gesichert werden.

Zu weiteren Informationen siehe auch

Bilder als Datei erkennen

Bilder und Dateien in FirstSpirit

Die Medien-Verwaltung von FirstSpirit dient der Verwaltung aller verwendeten Medien eines Projektes. Dies können

  • Bilder (Type Picture) beliebiger Grafikformate sein (z. B. PNG , JPG, WebP) oder
  • andere Medienformate (Type File) (z. B. PDF-, MP3- oder Video-Dateien).

Verwendung nicht unterstützter Grafikformate

FirstSpirit unterstützt nicht alle verfügbaren Grafikformate.

Nicht unterstützte Grafikformate werden nach dem erfolgreichen Upload in der Medien-Verwaltung des Projekts nicht als Medien vom Typ Picture angelegt, sondern als Medien vom Typ File.

Diese Medien können in FirstSpirit zwar verwendet bzw. referenziert werden. Funktionalitäten, wie z. B. der Bildzuschnitt oder ein Vorschaubild sind für nicht unterstützte Grafikformate aber nicht verfügbar.

Kompatibilitätsmodus - Bilder als Datei erkennen

Bestehende Medien ändern ihren Typ nicht automatisch von File auf Picture:
Wird ein Grafikformat (z. B. SVG) in einer neueren FirstSpirit-Version unterstützt, bleibt die Zuordnung von bereits vorhandenen Medien in den Projekten aus Kompatibilitätsgründen bestehen.

Dazu wird für bestehende Projekte bei der Aktualisierung auf eine neue FirstSpirit-Version die Kompatibilitätseinstellung „Bilder als Datei erkennen“ mit der entsprechenden Dateierweiterung gesetzt (z. B.: „svg“).

Für das Projekt gilt dann:

  • Die nun unterstützten Grafikformate werden im Projekt weiterhin als Medien vom Typ File verwaltet.
  • Neu angelegte Medien werden in diesem Projekt ebenfalls als Medium vom Typ File erkannt.

Für alle neuen Projekte bleibt die Kompatibilitätseinstellung leer. Hier gilt:

  • Bei neu angelegten Medien wird ein SVG jetzt automatisch als Medium vom Typ Picture erkannt und ein Vorschaubild berechnet.

Wichtig Ist der automatisch gesetzte Kompatibilitätsmodus für ein Projekt nicht gewünscht, kann die Konfiguration hier manuell geändert werden.

© 2005 - 2021 e-Spirit AG | Alle Rechte vorbehalten. | FirstSpirit 2021-07 | Datenschutz | Impressum | Kontakt