contentSelect

Verwendung der Funktion contentSelect

Mithilfe der Funktion contentSelect können Datensätze aus der Datenquellen-Verwaltung ausgegeben und zur weiteren Verarbeitung genutzt werden.

Die Funktion bietet die Möglichkeit Datensätze zu filtern und/oder zu sortieren.

Das Ergebnis (Rückgabewert) der Funktion ist eine Liste, die alle Datensätze enthält, auf die die Filterkriterien zutreffen.

Syntax der Funktion contentSelect

Der Grundaufbau der Funktion contentSelect sieht wie folgt aus:

<CMS_FUNCTION name="contentSelect" resultname="BEZEICHNER">
  <CMS_PARAM name="schema" value="BEZEICHNER" />
  <CMS_VALUE_PARAM name="BEZEICHNER" value="WERT" />
  ...
  <QUERY entityType="BEZEICHNER">
    <FILTERPARAM parameter="BEZEICHNER" datatype="DATENTYP" value="VORBELEGUNG" />
    <FETCHMODE attribute="ATTRIBUT" lazy="NUMERISCHER_BOOLESCHER_WERT" />
    <ORDERCRITERIA attribute="ATTRIBUT" descending="NUMERISCHER_BOOLESCHER_WERT" />
      ...
    <EQ attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <NEQ attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <GT attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <GTE attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <LT attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <LTE attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <IS_NULL attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <NOTNULL attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <LIKE attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
    <AND>
      <EQ attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
      ...
      <LIKE attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
      <OR>
        ...
      </OR>
      ...
    </AND>
    <OR>
      <EQ attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
      ...
      <LIKE attribute="ATTRIBUT" parameter="BEZEICHNER" datatype="DATENTYP" value="WERT" />
      <AND>
        ...
      </AND>
      ...
    </OR>
    ...
  </QUERY>
</CMS_FUNCTION>

DTD-Darstellung

Die DTD-Darstellung der Syntax für das QUERY-Tag (Abfrageteil):

<!DOCTYPE QUERY [
  <!-- "and" compare ("&&") -->
  <!ELEMENT AND (EQ|GT|GTE|IS_NULL|LIKE|LT|LTE|NEQ|NOTNULL|OR)+>

  <!-- equals ("==") -->
  <!ELEMENT EQ (#PCDATA)>
  <!ATTLIST EQ
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!ELEMENT FETCHMODE (#PCDATA)>
  <!ATTLIST FETCHMODE
    attribute CDATA #REQUIRED
    lazy (0|1) #REQUIRED>

  <!ELEMENT FILTERPARAM (#PCDATA)>
  <!ATTLIST FILTERPARAM
    parameter CDATA #REQUIRED
    datatype CDATA #REQUIRED
    value CDATA #REQUIRED>

  <!-- greater than (">") -->
  <!ELEMENT GT (#PCDATA)>
  <!ATTLIST GT
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!-- greater than or equals (">=") -->
  <!ELEMENT GTE (#PCDATA)>
  <!ATTLIST GTE
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!-- is null ("== null") -->
  <!ELEMENT IS_NULL (#PCDATA)>
  <!ATTLIST IS_NULL
    attribute CDATA #REQUIRED>

  <!-- "like"  compare ("%") -->
  <!ELEMENT LIKE (#PCDATA)>
  <!ATTLIST LIKE
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!-- lesser than ("<") -->
  <!ELEMENT LT (#PCDATA)>
  <!ATTLIST LT
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!-- lesser than or equals ("<=") -->
  <!ELEMENT LTE (#PCDATA)>
  <!ATTLIST LTE
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!-- not equals ("!=") -->
  <!ELEMENT NEQ (#PCDATA)>
  <!ATTLIST NEQ
    attribute CDATA #REQUIRED
    parameter CDATA #IMPLIED
    datatype CDATA #IMPLIED
    value CDATA #IMPLIED>

  <!-- not null ("!= null") -->
  <!ELEMENT NOTNULL (#PCDATA)>
  <!ATTLIST NOTNULL
    attribute CDATA #REQUIRED>

  <!-- "or" compare ("||") -->
  <!ELEMENT OR (AND|EQ|GT|IS_NULL|LIKE|LT|LTE|NEQ|NOTNULL)+>

  <!-- sorting order criteria -->
  <!ELEMENT ORDERCRITERIA (#PCDATA)>
  <!ATTLIST ORDERCRITERIA
    attribute CDATA #REQUIRED
    descending (0|1) #IMPLIED>

  <!-- root tag -->
  <!ELEMENT QUERY (AND|EQ|FETCHMODE|FILTERPARAM|GT|GTE|IS_NULL|LIKE|LT|LTE|NEQ|NOTNULL|OR|ORDERCRITERIA)*>
  <!ATTLIST QUERY
    entityType CDATA #REQUIRED>
]>

Parameter der Funktion contentSelect

Die Funktion contentSelect lässt sich in einen Definitions- und einen Abfrageteil unterteilen.

Der Definitionsteil besteht aus folgenden Parameter:

• schema
• beliebige Parameter zur Verwendung im Abfrageteil

Der Abfrageteil, erkennbar am QUERY-Tag, verfügt zusätzlich über spezielle Tags, um die Abfrage zu formulieren. Die verfügbaren Tags lauten:

• AND
• EQ
• FETCHMODE
• FILTERPARAM
• GT
• GTE
• IS_NULL
• LIKE
• LT
• LTE
• NEQ
• NOTNULL
• OR
• ORDERCRITERIA

Definitionsteil

schema

Mit dem Parameter schema wird das Datenbankschema angegeben, welches für die Abfrage genutzt werden soll.

Als Wert des Parameters wird der Referenzname des Datenbankschemas in der Datenquellen-Verwaltung angegeben:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="KONSTANTE" />
  ...
</CMS_FUNCTION>

beliebige Parameter

Mit der Definition eines frei wählbaren Bezeichners können beliebig viele Ausdrücke der Abfrage als Parameter zur Verfügung gestellt werden.

Für den Bezeichner dürfen folgende Zeichen verwendet werden:

A bis Z, a bis z, 0 bis 9 und _.

Definition unter Angabe von Ausdrücken:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_VALUE_PARAM  name="BEZEICHNER" value="AUSDRUCK" />
  ...
</CMS_FUNCTION>

Beispiel für die Definition der Parameter von und bis:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <CMS_VALUE_PARAM  name="bis" value="#global.now" />
  ...
</CMS_FUNCTION>

Anmerkung: Bei st_startDate handelt es sich um eine Datums-Eingabekomponente (CMS_INPUT_DATE). Bei #global.now um den Startpunkt der Veröffentlichung.

Abfrageteil (QUERY)

Der Abfrageteil einer contentSelect-Funktion wird mit einem QUERY-Tag begonnen. Das QUERY-Tag ist gleichzeitig das Wurzelelement der Abfrage.

Alle Tags, die zwischen dem öffnenden und schließenden QUERY-Tag angegeben werden, werden bei der Abfrage berücksichtigt.

Mit dem Parameter entityType wird der symbolische Tabellenname im Datenbankschema angegeben, damit die Abfrage auf die Datensätze der zugehörigen Datenbanktabelle angewendet werden kann.

Vorlagen für eine Abfrage können für eine Tabelle des Datenbankschema mihilfe einer Abfrage erstellt werden. Hierzu wird die Abfrage im Wizard-Modus definiert. Nach der Fertigstellung der Abfrage wird dieser Modus verlassen. Die damit erzeugte Abfrage lässt sich in der Regel ohne weitere Änderungen für die contentSelect-Funktion nutzen. Sollte eine Sortierung gewünscht werden, so muss diese noch hinzugefügt werden.

QUERY-Tags

Mit diesen Tags lassen sich unterschiedliche Anfragen ("Queries") erzeugen – unter Berücksichtigung von Filterungen oder gewünschten Sortierungen.

Tag FILTERPARAM

Über das Tag FILTERPARAM können die im Definitionsteil definierten "beliebigen Parameter" auch in der Abfrage genutzt werden.

Da der Wert der im Definitionsteil definierten Parameter häufig der Wert einer Variablen ist (z. B. aus einer Eingabekomponente, aus der Struktur-Verwaltung o.ä.), ist das Tag die Verbindungsstelle zwischen der Datenbank und FirstSpirit.

Für den Pflichtparameter parameter ist als Wert der Bezeichner des Parameters im Definitionsteil anzugeben.

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" ... />
    ...
  </QUERY>
</CMS_FUNCTION>

Mit dem Parameter datatype wird der Datentyp des Wertes angegeben. Der Typ sollte mit dem Datentyp der Spalte im Schema übereinstimmen, damit es nicht zu einem Fehler bei der Ausführung der Abfrage kommt.

Gebräuchliche Datentypen sind:

• java.util.Date für Datumsspalten
• java.lang.String für String-Spalten
• java.lang.Boolean für Boolean-Spalten
• java.lang.Double für Double-Spalten
• java.lang.Integer für Integer-Spalten
• java.lang.Long für Long-Spalten

Zusätzlich gibt es besondere Datentypen für Datumsspalten:

• de.espirit.common.Now für den Startzeitpunkt der Veröffentlichung
• de.espirit.common.Today für Heute.

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" ... />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei dem Parameter value handelt es sich um einen Vorbelegungswert. Dieser Parameter sollte immer definiert werden. Er wird benötigt, wenn kein Parameter mit dem in parameter angegebenen Bezeichner im Definitionsteil definiert wurde.

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    ...
  </QUERY>
</CMS_FUNCTION>

Tag FETCHMODE

Da ein Datensatz im Abfrageergebnis potentiell große bzw. viele Daten enthält – insbesondere bei Fremdschlüsseln – kann es sinnvoll sein, die Daten der Fremdschlüssel (das sogenannte Datensatzattribut) erst bei Zugriff bzw. bei der Weiterverarbeitung zu laden.

Um das Ladeverhalten solcher Attribute zu ändern, gibt es das Tag FETCHMODE.

Das Tag verfügt über zwei Parameter:

1. attribute
2. lazy

Für attribute wird der Name der Spalte im Schema angegeben, für die das Ladeverhalten geändert werden soll.

Mit dem Parameter lazy wird festgelegt, wie die Daten der Spalte geladen werden sollen. lazy=1 bedeutet, dass die Daten bei Bedarf geladen werden (= Standardeinstellung). lazy=0 bedeutet, dass die Daten sofort geladen werden.

Tag ORDERCRITERIA

Das Tag ORDERCRITERIA dient dazu, das Ergebnis einer Abfrage zu sortieren. Dazu kann in jedem Tag ein Sortierkriterien angegeben werden.

Mit dem Pflichtparameter attribute wird die Tabellenspalte angegeben, die als Sortiergrundlage dienen soll.

Innerhalb des Parameters kann der Platzhalter %lang% verwendet werden, der bei einer Vorschau/Generierung gegen die Abkürzung der aktuellen Sprache ausgetauscht wird (z. B. DE, EN usw).

Beispiel:

  <ORDERCRITERIA attribute="date"... />
  <ORDERCRITERIA attribute="text_%lang%"... />
  ...

Weiterhin gibt es die Möglichkeit, mit dem Parameter descending die Sortierrichtung zu ändern. Wird der Parameter nicht angegeben, wird die Ergebnismenge der Abfrage aufsteigend (descending="0") sortiert. Wird descending="1" definiert, so wird die Ergebnismenge absteigend sortiert.

  <ORDERCRITERIA attribute="date" descending="0" />
  <ORDERCRITERIA attribute="text_%lang%" />
  ...

Tag AND / OR

Mit dem AND-/OR-Tag ist es möglich, weitere Abfragetags, wie z. B. EQ, LIKE, IS_NULL, miteinander zu verknüpfen.

Tags, die in einem AND-Tag angegeben werden, werden logisch-und- und in einem OR-Tag logisch-oder-verknüpft.

Die Schachtelung von AND- und OR-Tags ist nur abwechselnd möglich.

Beispiel für eine nicht zulässige Schachtelung:

...
<AND>
  <AND>
     <EQ attribute="abbreviation" value="etc" />
  </AND>
</AND>
...

Beispiel für eine zulässige Schachtelung:

...
<AND>
  <OR>
    <AND>
      <EQ attribute="abbreviation" value="etc" />
    </AND>
  </OR>
</AND>
...

Beim folgenden Beispiel werden als Ergebnismenge der Abfrage alle Daten ausgegeben, bei denen Abfrage1 und (Abfrage2 oder Abfrage3) zutreffen:

<AND>
  <ABFRAGE1... />
  <OR>
    <ABFRAGE2... />
    <ABFRAGE3... />
  </OR>
</AND>

Tag EQ (Equal)

Das Tag EQ wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Inhalt in der überprüften Spalte mit dem Vergleichswert übereinstimmt (Gleichheitsprüfung)

Die Definition eines EQ-Tags kann mithilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <EQ attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <EQ attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.

Tag NEQ (Not Equal)

Das Tag NEQ wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Inhalt in der überprüften Spalte nicht mit dem Vergleichswert übereinstimmt (Ungleichheitsprüfung).

Die Definition eines NEQ-Tags kann mithilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <NEQ attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <NEQ attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.

Tag GT (greater than)

Das Tag GT wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Werte in der überprüften Spalte größer sind, als der angegebene Vergleichswert (Größerprüfung).

Die Definition eines GT-Tags kann mit Hilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <GT attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <GT attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.

Tag GTE (greater than or equal)

Das Tag GTE wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Werte in der überprüften Spalte größer oder gleich dem angegebenen Vergleichswert sind (Größer-/Gleichprüfung).

Die Definition eines GTE-Tags kann mithilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <GTE attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <GTE attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.

Tag LT (less than)

Das Tag LT wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Werte in der überprüften Spalte kleiner sind als der angegebene Vergleichswert (Kleinerprüfung).

Die Definition eines LT-Tags kann mithilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <LT attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <LT attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.

Tag LTE (less than or equal)

Das Tag LTE wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Werte in der überprüften Spalte kleiner oder gleich dem angegebenen Vergleichswert sind (Kleiner-/Gleichprüfung).

Die Definition eines LTE-Tags kann mithilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <LTE attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <LTE attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.

Tag IS_NULL

Das Tag IS_NULL wird dazu verwendet, Abfragen zu definieren, die alle Datensätze zurückliefern, die keinen Wert in der überprüften Spalte haben (Null-Prüfung).

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <IS_NULL attribute="spaltenName" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Definition ist der Parameter attribute anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Tag NOTNULL

Das Tag NOTNULL wird dazu verwendet, Abfragen zu definieren, die alle Datensätze zurückliefern, die einen Wert in der überprüften Spalte haben (Nicht-Null-Prüfung).

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <NOTNULL attribute="spaltenName" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Definition ist der Parameter attribute anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Tag LIKE

Das Tag LIKE wird verwendet, um Abfragen zu definieren, die alle Datensätze zurückliefern, deren Werte in der überprüften Spalte ähnlich zum angegebenen Vergleichswert sind (Ähnlichkeitsprüfung).

Bei der Angabe des Vergleichswerts kann der Platzhalter % verwendet werden, der für beliebige Zeichen steht.

Die Angabe von %aus liefert somit alle Begriffe zurück, die auf aus enden, z. B. Maus, Haus usw.

Die Definition eines LIKE-Tags kann mithilfe einer Variablen (Tag FILTERPARAM) oder direkt erfolgen.

Direkte Definition:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <QUERY entityType="tabellenName">
    <LIKE attribute="spaltenName" datatype="java.lang.Integer" value="wert" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der direkten Definition sind die Parameter attribute, datatype und value anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem datatype wird der Datentyp für den Vergleich angegeben (vgl. hierzu auch das Tag FILTERPARAM).

Der Parameter value dient zur Angabe eines Vergleichswerts.

Unter Verwendung einer Variablen:

<CMS_FUNCTION name="contentSelect" resultname="name">
  <CMS_PARAM  name="schema" value="datenbankSchemaName" />
  <CMS_VALUE_PARAM  name="von" value="st_startDate" />
  <QUERY entityType="tabellenName">
    <FILTERPARAM parameter="von" datatype="java.util.Date" value="1143758280000" />
    <LIKE attribute="spaltenName" parameter="von" />
    ...
  </QUERY>
</CMS_FUNCTION>

Bei der Verwendung von Variablen, die der Abfrage mit CMS_VALUE_PARAM und FILTERPARAM zur Verfügung gestellt wurden, sind die Parameter attribute und parameter anzugeben.

Für attribute wird der Name der Spalte im Schema angegeben, die für den Vergleich herangezogen werden soll.

Mit dem Parameter parameter wird angegeben, welche mit dem Tag FILTERPARAM definierte Variable als Vergleichswert genutzt werden soll.