Ausgabe von Verweisen
Ausgabe einer Verweisvorlage
Damit die redaktionellen Inhalte von Eingabekomponenten im jeweiligen Ausgabekanal sichtbar sind, muss die Ausgabe innerhalb der Vorlagen definiert werden. Das Gleiche gilt für die Eingabekomponenten zur Pflege von Verweisen. Die Inhalte, die vom Redakteur in die entsprechenden Felder der Eingabemaske eingegeben wurden, werden über die Verweisvorlagen ausgegeben.
Ist in der Baumansicht eine Verweisvorlage selektiert, erscheint im rechten Fensterbereich ein Bearbeitungsfenster mit einem oder mehreren Registern, für jeden zur Verfügung stehenden Ausgabekanal.
Der Vorlagenentwickler muss für jeden Ausgabekanal der Verweisvorlage die entsprechenden Anweisungen definieren.
Die Feldinhalte werden entweder über die Anweisung $CMS_VALUE(...)$ oder über die Anweisung $CMS_REF(...)$ ausgegeben, abhängig davon, um welche Eingabekomponente es sich handelt.
Dabei gilt für Textfelder und Auswahllisten (z.B. für die Felder "comment", "text", "language"):
$CMS_VALUE(#link.Feldname)$
und für das Auflösen von Referenzen (z.B. für die Felder "ref", "sitestoreref", "mediaref"):
$CMS_REF(#link.Feldname)$
Für das Auflösen von Referenzen die aus einem Remoteprojekt stammen, müssen die entsprechenden Remoteattribute angegeben werden:
$CMS_REF(#link.Feldname, remote:#link.Feldname_remote)$
Systemobjekt #link
Statt mit einer Variablen wird beim Arbeiten mit Verweisen mit dem Verweisobjekt #link gearbeitet. Die Werte bzw. Inhalte der Eingabefelder können über folgende Syntax (Bean-Syntax) aufgerufen werden:
#link.Feldname
also beispielsweise:
#link.mediaref
Bei der Auflösung der Verweise (bei der Generierung einer Seite) werden die Parameter mit den entsprechenden getter-Methoden verknüpft (z.B. #link.getMediaref()) und ausgegeben.
Welche Felder bzw. welche Feldnamen zur Verfügung stehen, ist abhängig vom gewählten Verweistyp.
Alle Feldnamen werden ausführlich in den folgenden Kapiteln erläutert:
- für interne Verweise: Liste aller "name"-Attribute für Verweise innerhalb des Projekts.
- für externe Verweise: Liste aller "name"-Attribute für Verweise außerhalb des Projekts.
- für content Verweise: Liste aller "name"-Attribute für Verweise auf einen Datensatz einer Datenquelle.
Analog dazu, kann auch die JAVA-Syntax verwendet werden (vg. Kap. FirstSpirit™ API), also beispielsweise:
#link.getMediaref()