Variablen in Metadaten (Metadatenvariablen)

Metadaten (singular: Metainformation) sind zusätzliche Informationen, die für ein FirstSpirit-Objekt zur Verfügung stehen. Dabei kann es sich um vom System vergebene Metadaten handeln (z. B. „letztes Änderungsdatum“, „letzter bearbeitender Redakteur“, „Freigegeben von“), es besteht aber auch die Möglichkeit, weitere projektspezifische Metadaten zu definieren.

Definition von Metadaten

Metadaten-Vorlage: Auswahl im ServerManager

Zur Definition von Metadaten wird eine Metadaten-Vorlage benötigt.

Dazu sind folgende Schritte notwendig:

1. Zunächst wird eine Seitenvorlage in der Vorlagen-Verwaltung des Projekts angelegt (SiteArchitect, siehe Kapitel Seitenvorlagen).
2. Die neue Vorlage muss anschließend im ServerManager in den Projekteigenschaften (Menü „Optionen“, Feld „Metadaten-Vorlage“) als Metadaten-Vorlage ausgewählt werden (siehe Abbildung, siehe auch Optionen (→Dokumentation für Administratoren)).
3. Nach dieser Definition der Metadaten-Vorlage für ein Projekt, wird in allen Verwaltungsbereichen im SiteArchitect das Register „Metadaten“ angezeigt. Innerhalb der Register können die Redakteure Inhalte mithilfe der in der Metadaten-Vorlage definierten Eingabekomponenten pflegen (siehe dazu Metadaten (→Handbuch FirstSpirit SiteArchitect)).

Analog zu einer Seitenvorlage kann die Metadaten-Vorlage alle FirstSpirit Eingabekomponenten (Formulare) verwenden. Für das Erstellen der Metadaten-Vorlage müssen jedoch folgende Punkte beachtet werden:

• Metadaten sind nicht sprachabhängig, daher wird für die Beschriftung der Eingabekomponenten (LANGINFOS / LANGINFO) nur die Rückfall-Definition (lang="*") berücksichtigt.
• Generell wird von der Verwendung von Rückgriffwerten (siehe dazu Seite Vorgabewerte) abgeraten.
• Einige Eingabekomponenten können, unabhängig davon, ob der Redakteur eine Eingabe vorgenommen hat oder nicht, nicht leer sein (beispielsweise CMS_INPUT_DOMTABLE) oder nach der ersten Eingabe des Redakteurs nicht mehr geleert werden (beispielsweise CMS_INPUT_DOM, CMS_INPUT_RADIOBUTTON) (siehe Abschnitt Verwendung von Metadaten).

Verwendung von Metadaten

Jeder Eingabekomponente wird innerhalb der Metadaten-Vorlage ein eindeutiger Bezeichner (Variablenname) zugewiesen. Der Variableninhalt (der Metadatenvariablen) kann innerhalb der Vorlagensätze über das Systemobjekt #global in Verbindung mit der Methode .meta() ausgegeben werden.

Metadateninhalte werden im FirstSpirit SiteArchitect durch das Icon im Projektbaum gekennzeichnet. Zum Einblenden des Symbols muss im Menü „Ansicht“ der Menüpunkt „Symbole einblenden“ aktiviert werden.

Eine Metainformation gilt auf einem Knoten als gesetzt, sobald eine Eingabe in einer Eingabekomponente erfolgt und gespeichert wird, das Icon wird angezeigt, sobald eine Metainformation gesetzt ist. Einige Eingabekomponenten können nicht „geleert“ werden, z. B. im Fall von CMS_INPUT_DOM, indem der gesamte Inhalt aus der Komponente entfernt wird. Auf einen tatsächlich „leeren“ Stand kann ein Knoten über die Funktion „Metadaten löschen“ im Kontextmenü unter „Extras“ gesetzt werden. Über die Wiederherstellen-Funktion in der Versionshistorie eines Knotens (siehe dazu Funktionen der Versionshistorie (→Handbuch FirstSpirit SiteArchitect)) können Metadaten auch auf einen vorherigen Stand zurückgesetzt werden (Option „Metadaten zurücksetzen“). Allerdings beziehen sich diese beiden Funktionen („Metadaten löschen“ und „Metadaten zurücksetzen“) immer auf den gesamten Knoten und nicht auf einzelne Eingabekomponenten der Metadaten-Vorlagen.

Vererbung von Metadaten

Metadaten können auf untergeordnete Knoten vererbt werden, so dass sie im Idealfall nur an wenigen Stellen im Projekt gepflegt werden brauchen und für hierarchisch abhängige Knoten oder Teilbäume übernommen werden können.

Dabei kann über folgende Attribute in der Ausgabe bestimmt werden, welche Metadaten bei der Vererbung berücksichtigt werden sollen:

• none: keine Vererbung – Es werden bei der Ausgabe keine Metadaten aus übergeordneten Knoten berücksichtigt.
• inherit: Rückgriff auf Vaterknoten – Sind auf dem aktuellen Knoten keine Metadaten hinterlegt, werden bei der Ausgabe die Metadaten des nächst höherliegenden Knotens der Verwaltung berücksichtigt.
• add: additive Vererbung – Es werden bei der Ausgabe die Metadaten aller übergeordneten Knoten, ausgehend vom Wurzelknoten der Verwaltung, berücksichtigt.

Wird keine Ausgabeart angegeben, werden die Daten direkt aus dem angegebenen Knoten gelesen (entspricht none). Weitere Informationen zu diesen Ausgabearten siehe #global und Metainformationen.

Hinweise zur Verwendung von add
Bei der Ausgabe bzw. Auswertung von Metadaten kann zwar die Vererbung von Metadaten auf untere Hierarchie-Ebenen berücksichtigt werden. In den betreffenden Eingabekomponenten werden dem Redakteur aber immer nur die auf dem aktuellen Knoten definierten Metadaten angezeigt, nicht die ererbten Metadaten. Dies kann zu Fehlbedienungen führen.

Hinweis zur Verwendung von Metadaten in Absatzreferenzen
In Absatzreferenzen werden bei der Ausgabe über die Parameter none und inherit zur Ermittlung der Metainformationen der jeweilige Quellabsatz (Absatz, von dem die Absatzreferenz erstellt wurde) herangezogen bzw. die Objektkette des Quellabsatzes, bei der Ausgabe über add dagegen die Objektkette der Absatzreferenz (siehe dazu auch Absatzreferenzen (→Handbuch FirstSpirit SiteArchitect)).