Startseite / Vorlagenentwicklung / Verweisvorlagen / Konfiguration / für Daten-Verweise

Konfiguration für Verweise auf einen Datensatz (contentLink)

Beispiel Eingabemaske "contentLink" (1)

Die beiden Grafiken auf der linken Seite, zeigen ein Beispiel zu einer Eingabemasken für einen Verweis auf einen Datensatz.

Die Eingabemaske ist unterteilt in zwei Register:

Das erste Register, in der Grafik mit "Datenverweis" beschriftet, ist dabei analog zum internen Verweis aufgebaut
(vgl. Abbildung: Beispiel Eingabemaske "contentLink" (1)).
Das zweite Register dient der Datensuche innerhalb der Datenquellen- und der Struktur-Verwaltung
(vgl. Abbildung: Beispiel Eingabemaske "contentLink" (2)).

Beispiel Eingabemaske "contentLink" (2)

Die beiden Grafiken zeigen alle, für diesen Verweistyp, möglichen Eingabefelder an.

Ist für eine Instanz eines Daten-Verweises keine explizite Konfiguration angegeben, werden standardmäßig alle Komponenten mit ihren Standardwerten angezeigt.

Der Vorlagenentwickler kann jedes Eingabefeld durch Angabe des Attributs "name" im <CMS_PARAM>-Tag projektspezifisch konfigurieren (vgl. Kapitel Konfiguration). Die Attributnamen, durch welche die jeweiligen Eingabefelder bzw. Auswahllisten beeinflusst werden können, sind in der Grafik kursiv dargestellt. (Zum Vergrößern bitte auf die Grafik klicken!)

Die folgenden Variablen können für alle Instanzen des Standard-Verweistyps "contentLink", zur Konfiguration von Verweisen auf einen Datensatz (aus der Datenquellen-Verwaltung), verwendet werden.

Spezielle Variablen "Datenverweis" (Verweistyp: contentLink)

Feldname	Beschreibung
text	Das Feld "text" ist eine Eingabekomponente für die Eingabe eines Verweistexts. In das Feld kann ein beliebiger Text eingegeben werden, der verlinkt werden soll. Über die Konfiguration kann das Standardverhalten der Eingabekomponente verändert werden. Beispiel: <CMS_PARAM name="text" label="Verweistext"/>
comment	Das Feld "comment" ist eine Eingabekomponente für die Eingabe eines Kommentars. Der Redakteur kann in das Eingabefeld einen beliebigen Kommentartext eingeben, der beispielsweise als "tooltip" angezeigt werden kann. Über die Konfiguration kann das Standardverhalten der Eingabekomponente verändert werden. Beispiel: <CMS_PARAM name="comment" value="Bitte hier klicken!"/>
linktemplate	Das Feld "linktemplate" ist eine Auswahlliste für die Auswahl einer Verweisvorlage. Standardmäßig enthält die Auswahlliste alle Verweisvorlagen der aktuellen Instanz des Verweisvorlagentyps. (Begriffserklärung: siehe Einleitung Verweisvorlagen) Der Redakteur kann aus der Liste die Verweisvorlage auswählen, die zur Erstellung des Verweises verwendet werden soll. Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden. Über die Definition mehrerer Parameter, kann die Auswahlliste vom Vorlagenentwickler, beispielsweise mit einer beliebigen Anzahl an gültigen Verweisvorlagennamen vorbelegt werden. Für das Attribut value ist der eindeutige Bezeichner anzugeben. <CMS_PARAM name="linktemplate" value="myInternalLink.standardLink1"/> <CMS_PARAM name="linktemplate" value="myInternalLink.standardLink2" default="1" /> <CMS_PARAM name="linktemplate" value="myInternalLink.standardLink3"/> Die Elemente werden in der Liste, in der vom Vorlagenentwickler konfigurierten Reihenfolge dargestellt.
mediaref	Das Feld "mediaref" ist eine Eingabekomponente für die Auswahl eines Medienobjekts aus der Medien-Verwaltung des Projekts, das verlinkt werden soll. Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden. Beispiel: <CMS_PARAM name="mediaref" value="media:abc" default="1"/> Die ausgewählte Referenz muss im Quelltext der Verweisvorlage mittels $CMS_REF(#link.mediaref)$ aufgelöst werden.
target	Das Feld "target" ist eine Eingabekomponente für die Auswahl eines Zielframes für den Verweis, beispielsweise im aktuellen Fenster oder in einem Popup-Fenster. Der Verweis wird im selektierten Zielframe geöffnet. Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden, beispielsweise kann die Liste vom Vorlagenentwickler mehrfach vorbelegt werden: <CMS_PARAM name="target" value="_top"/> <CMS_PARAM name="target" value="_self" default="1"/> <CMS_PARAM name="target" value="_blank"/> Über das Attribut "value" können die gängigen HTML-Frame-Bezeichner aber auch projektspezifisch definierte Frames zur Auswahl gestellt werden.
language	Das Feld "language" ist eine Eingabekomponente für die Auswahl einer Sprache für den Verweis. Standardmäßig werden in der Auswahlliste alle Sprachen des Projekts angezeigt. Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden, beispielsweise kann der Vorlagenentwickler eine Sprache vorselektieren: <CMS_PARAM name="language" value="DE" default="1"/>
remotemedia	Das Feld "remotemedia" definiert, welches Remote-Projekt für die Auswahl eines Medienobjektes aus der Medien-Verwaltung zur Verfügung steht. Für das Attribut value ist der symbolische Name des Remoteprojektes anzugeben: <CMS_PARAM name="remotemedia" value="symbNameRemoteproject"/> Alternativ kann mit dem Schlüsselbegriff category der Bezeichner der Remote-Kategorie angegeben werden: <CMS_PARAM name="remotemedia" value="category:categoryName"/> Wird bei der Konfiguration für das Feld "mediaref" das optionale Attribut value="showremotemediastore" angegeben: <CMS_PARAM name="mediaref" value="showremotemediastore"/> wird dem Redakteur, neben der Medien-Verwaltung des internen Projektes, zusätzlich noch die Medien-Verwaltung des Remote-Projektes angezeigt. Wird bei der Konfiguration für das Feld "mediaref" das optionale Attribut value="remoteonly" angegeben: <CMS_PARAM name="mediaref" value="remoteonly"/> wird dem Redakteur ausschließlich die Medien-Verwaltung des Remote-Projektes angezeigt.

Spezielle Variablen "Datensuche" (Verweistyp: contentLink)

Feldname	Beschreibung
contentSource	Mit dem Feld contentSource kann eine Datenquelle für die Auswahl aus der Datenquellen-Verwaltung des Projektes vorgegeben werden. Hierfür ist als Wert des Parameters value der Referenzname der Datenquelle aus der Datenquellen-Verwaltung anzugeben. Zusätzlich ist der Parameter default mit dem Wert 1 anzugeben: <CMS_PARAM name="contentSource" value="REFERENZNAME" default="1" /> Wichtig: Der Parameter contentSource hat keinerlei Auswirkungen auf die Auswahlmenge der Datenquellen, d.h. der Redakteur kann weiterhin aus allen Datenquellen auswählen. Zur Einschränkung der Auswahlmenge kann der Parameter contentSources verwendet werden.
contentSources	Der Parameter contentSources schränkt die Auswahlmenge der Datenquellen ein, d.h. im Auswahldialog für das Feld contentSource stehen nur die angegebenen Datenquellen zur Verfügung. Ein <CMS_PARAM>-Tag entspricht einer zugelassenen Datenquelle: <CMS_PARAM name="contentSources" value="REFERENZNAME1" /> <CMS_PARAM name="contentSources" value="REFERENZNAME2" /> <CMS_PARAM name="contentSources" value="REFERENZNAME3" /> Als Wert ist für den Parameter value der Referenzname der Datenquelle aus der Datenquellen-Verwaltung anzugeben. Wichtig: Die Parameter default und hidden sind für contentSources nicht verfügbar, da der Wert von contentSources nicht in einem Verweis gespeichert wird.
contentID	Durch einen Klick auf das Ankersymbol öffnet sich ein Fenster mit der Tabellenansicht der ausgewählten Datenquelle.
sitestoreref	Über das Ankersymbol kann eine Seite oder ein Ordner aus der Struktur-Verwaltung ausgewählt werden, die bzw. der als Startpunkt für die Suche nach dem angegebenem Datensatz dienen soll.
sectiontemplate	Eine Tabelle in einem Schema in der Vorlagen-Verwaltung kann von mehr als einer Tabellenvorlage dargestellt werden. Wurde für das Feld contentSource eine Datenquelle ausgewählt oder vorbelegt, so werden im Feld sectiontemplate alle Tabellenvorlagen angezeigt, die die gleiche Tabelle wie diese darstellen.

Druckversion | Seitenanfang