Startseite
Startseite

Startseite / Vorlagenentwicklung / Formulare / Datenelemente / OPTIONS / TEMPLATESET

Typ TEMPLATESETVerfügbar ab FirstSpirit-Version 4.2

Inhaltsverzeichnis
zum Beispiel

Mit dem Typ TEMPLATESET ist es möglich, in einer mengenwertigen Eingabekomponente (z. B. CMS_INPUT_COMBOBOX) die im Projekt definierten Ausgabekanäle automatisch einzufügen.

type
IncludeType
Pflichtparameter
lang
String
Pflichtparameter
<CMS_INCLUDE_OPTIONS></CMS_INCLUDE_OPTIONS>

Parameter

Bei dem Tag CMS_INCLUDE_OPTIONS handelt es sich um einen Container, mit dem Konfigurationen festgelegt werden können, um Einträge in eine Eingabekomponente automatisch einzufügen.

ParameterPflichtparameterSeitTypStandardwert
type*Ja4.2IncludeTypeKeiner

type

Mit dem Pflichtparameter type wird der Typ der Werte- bzw. Inhaltsinkludierung angegeben.

Folgende Typen werden unterstützt:

  • LANGUAGE: gibt die Projektsprachen aus
  • TEMPLATESET: gibt die Ausgabekanäle des Projekts aus
  • DATABASE: gibt den Inhalt von Datenquellen aus
  • PUBLIC: gibt den Inhalt, der über eine öffentliche Schnittstelle zur Verfügung gestellt wird, aus

  • Optionale Parameter
    Optional können weitere optionale und Pflicht-Parameter bzw. -Tags verwendet werden (siehe unten).

Typ LANGUAGE

Mit dem Typ LANGUAGE ist es möglich, in einer mengenwertigen Eingabekomponente (z.B. CMS_INPUT_COMBOBOX) die im Projekt definierten Sprachen automatisch einzufügen.

  • Pflichtparameter
    Das Tag LANGUAGE benötigt keine weiteren Parameter.
  • Optionale Parameter
    Optional zum Tag LANGUAGE können die Tags LABELS / LABEL verwendet werden (siehe unten).

Typ TEMPLATESET

Mit dem Typ TEMPLATESET ist es möglich, in einer mengenwertigen Eingabekomponente (z.B. CMS_INPUT_COMBOBOX) die im Projekt definierten Ausgabekanäle automatisch einzufügen.

  • Pflichtparameter
    Das Tag TEMPLATESET benötigt keine weiteren Parameter.
  • Optionale Parameter
    Optional zum Tag TEMPLATESET können die Tags LABELS / LABEL verwendet werden (siehe unten).

Typ DATABASE

Mit dem Typ DATABASE ist es möglich, in einer mengenwertigen Eingabekomponente (z.B. CMS_INPUT_COMBOBOX) Datensätze aus einer Fremdtabelle automatisch einzufügen.

  • Pflichtparameter
    Die Datenquelle, aus der die Daten geholt werden sollen, muss mit dem Tag TABLE angegeben werden (siehe unten).
  • Optionale Parameter
    Optional zum Tag DATABASE können die Tags KEY und LABELS / LABEL verwendet werden (siehe unten).

Typ PUBLIC

FirstSpirit bietet die Möglichkeit, eigene Module zu entwickeln und zu implementieren. Über den Typ PUBLIC können Schnittstellen ("HotSpots") vom Typ "Public" angesprochen werden (weitere Informationen zu diesem Komponenten-Typ sowie zur Modul-Entwicklung in FirstSpirit siehe FirstSpirit Entwicklerhandbuch für Komponenten).

  • Pflichtparameter
    Der Name der HotSpot-Klasse muss mit dem Tag NAME angegeben werden (siehe unten).
  • Optionale Parameter
    Optional zum Tag PUBLIC können die Tags PARAMS / PARAM sowie LABELS / LABEL verwendet werden (siehe unten).

ParameterPflichtparameterSeitTypStandardwert
type*Ja4.2IncludeTypeKeiner

LABELSVerfügbar ab FirstSpirit-Version 4.2

Zu jedem Typ kann über das Tag LABELS eine sprachabhängige Beschriftung der einzelnen Werte definiert werden.

Für jede Sprache muss dazu ein Tag LABEL angegeben werden.

ACHTUNG: Es muss mindestens eine Definition für die Rückfallbeschriftung ("*") erfolgen:

<LABELS>
<LABEL lang="*">...</LABEL>
</LABELS>

LABELVerfügbar ab FirstSpirit-Version 4.2

Mit dem Tag LABEL kann für jede Sprache eine flexible, sprachabhängige Beschriftung der einzelnen Optionen definiert werden.

Um die Beschriftung für eine Sprache festzulegen, ist im Parameter lang die Abkürzung der Projektsprache anzugeben:

...
<LABEL lang="DE">...</LABEL>
<LABEL lang="EN">...</LABEL>
...

Rückfallwerte werden mit dem speziellen Sprachkürzel * ("für alle Sprachen") angegeben:

...
<LABEL lang="*">...</LABEL>
...

Bei dem Parameter lang handelt es sich um einen Pflichtparameter.

Der Beschriftungstext wird innerhalb eines öffnenden und schließenden <LABEL>-Tag angegeben (siehe Platzhalter TEXT).

ParameterPflichtparameterSeitTypStandardwert
lang*Ja4.2StringKeiner

lang

Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe Dokument ansehen FirstSpirit Handbuch für Administratoren, Kapitel "Sprach-Vorlagen"), angegeben, um festzulegen für welche Projektsprachen die Definitionen gelten sollen, z.B. DE für Deutsch, EN für Englisch, FR für Französisch usw. Folgende Zeichen können dabei beliebig oft angegeben werden: -, _, 0-9 und A-Z. Kleinbuchstaben werden nach dem Speichern der Vorlage automatisch in Großbuchstaben umgewandelt. Alternativ kann * für Rückfallwerte verwendet werden.

ParameterPflichtparameterSeitTypStandardwert
lang*Ja4.2StringKeiner

TEXTVerfügbar ab FirstSpirit-Version 4.2

An dieser Stelle wird der Beschriftungstext der auszuwählenden Werte definiert.

Dazu steht das Systemobjekt #item zur Verfügung. Über dieses kann die Beschriftung dynamisch ausgegeben werden.

Beim Typ DATABASE repräsentiert #item dabei z. B. die anzuzeigende Datenbankzeile der über das Tag TABLE definierten Tabellenvorlage. Eine Spalte der Datenbankzeile kann durch einen Punkt getrennt für die Beschriftung verwendet werden, wie z. B. im Beispiel #item.Headline_EN.

Weiterhin werden über den Ausdrucksmechanismus sprachspezifische Endungen automatisch gesetzt, sollten sie vorhanden sein, d. h. folgende Definition ist möglich:

<CMS_INCLUDE_OPTIONS type="DATABASE">
<TABLE>Products.press_releases</TABLE>
<LABELS>
<LABEL lang="*">#item.Headline + ", " + #item.Subheadline</LABEL>
</LABELS>
</CMS_INCLUDE_OPTIONS>

Dabei wird abhängig von der zu generierenden Sprache zunächst für die einzelnen Attribute nach Attributen mit Spracherweiterung gesucht (z. B. #item.Headline_DE für die Sprache DE), und, falls diese nicht vorhanden ist, dann nach einem Attribut mit dem gegebenen Namen.

Wichtig Es ist darauf zu achten, dass der Spaltenname korrekt angegeben wird und die Spalten auch tatsächlich in der angegebenen Tabelle vorhanden ist, da sonst keine Werte zur Auswahl angezeigt werden. Bei Verwendung von KEY muss darüber hinaus darauf geachtet werden, dass die über LABEL und #item definierte dynamische Beschriftung zu der über KEY definierten Spalte passt. Ist dies nicht der Fall, erhält der Redakteur bei der Auswahl einer Option eine entsprechende Fehlermeldung.

Legende

String

Eine beliebige Zeichenkette

IncludeType

Typ der Werte- bzw. Inhaltsinkludierung

LANGUAGEVerfügbar ab FirstSpirit-Version 4.2

Liste der Projektsprachen

TEMPLATESETVerfügbar ab FirstSpirit-Version 4.2

Liste der im Projekt definierten Ausgabekanäle

DATABASEVerfügbar ab FirstSpirit-Version 4.2

Datensätze aus einer Fremdtabelle

PUBLICVerfügbar ab FirstSpirit-Version 4.2

Daten über Schnittstellen ("HotSpots") vom Typ "Public"

Beispiel

Ein Beispiel für die Verwendung von CMS_INCLUDE_OPTIONS, Typ TEMPLATESET:

<CMS_INPUT_COMBOBOX name="BEZEICHNER" useLanguages="no">
<CMS_INCLUDE_OPTIONS type="TEMPLATESET"/>
<LANGINFOS>
<LANGINFO lang="*" label="TEXT" description="TEXT"/>
<LANGINFO lang="DE" label="TEXT" description="TEXT"/>
</LANGINFOS>
</CMS_INPUT_COMBOBOX>

Dieses Beispiel gibt eine Combobox mit der Beschriftung TEXT aus, aus der die Ausgabekanäle des Projekts (z.B. "html", "pdf", "RSS" etc.) ausgewählt werden können.

© 2005 - 2014 e-Spirit AG | Alle Rechte vorbehalten. | Letzte Änderung: 2011-05-18