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.

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.

Übersicht

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).

Übersicht

LABELS

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>

LABEL

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).

Übersicht

lang

Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe 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.

Übersicht

TEXT

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.

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.

String	Eine beliebige Zeichenkette
IncludeType	Typ der Werte- bzw. Inhaltsinkludierung LANGUAGE Liste der Projektsprachen TEMPLATESET Liste der im Projekt definierten Ausgabekanäle DATABASE Datensätze aus einer Fremdtabelle PUBLIC Daten über Schnittstellen ("HotSpots") vom Typ "Public"

Beispiel

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

<CMS_INPUT_COMBOBOX name="BEZEICHNER" useLanguages="NO">
        <CMS_INCLUDE_OPTIONS type="LANGUAGE">
            <LABELS>
              <LABEL lang="*">#item.abbreviation</LABEL>
            </LABELS>
        </CMS_INCLUDE_OPTIONS>
        <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 Projektsprachen (z.B. "DE", "EN" etc.) ausgewählt werden können.