<we:conditionAdd />
Fügt der mit <we:condition> eingeleiteten Bedingung eine neue Regel/Vergleich hinzu.
ab Version | 2.2.0.0 |
Endtag erforderlich | nein |
Pflichtattribute |
Attribute
Bei diesem Attribut gibst Du als Wert den Namen des Objekt-Feldes an, mit welchem verglichen werden soll.
ab Version | 2.2.0.0 |
Typ | string |
Standardwert | - |
Bei diesem Attribut gibst Du den Wert an, der mit dem Inhalt des über das Attribut "field" definierten Objekt-Feldes verglichen werden soll.
Ab Version 9.2.1 können nun auch Felder vom Typ "multiobject" abgefragt werden. Als Value kann eine Liste von Objekt-IDs angegeben werden, nach denen gesucht wird
ab Version | 2.2.0.0 |
Typ | string |
Standardwert | - |
Bei diesem Attribut gibst Du als Wert den Operator an, mit welchem der Vergleich durchgeführt werden soll. Mögliche Werte sind:
= | gleich |
!= | ungleich |
< | kleiner als |
<= | kleiner gleich |
> | größer als |
>= | größer gleich |
like | wildcard matching mit % |
not like | negiertes wildcard matching mit % |
ab Version | 2.2.0.0 |
Typ | string |
mögliche Werte | =, !=, <, >, <=, >=, like, not like |
Standardwert | - |
Bei diesem Attribut gibst Du als Wert einen Variablennamen an, mit dessen Wert Du den Inhalt aus dem Feld, welches Du beim Attribut "field" definiert hast, vergleichen möchtest.
ab Version | 2.2.0.0 |
Typ | string |
Standardwert | - |
Bei diesem Attribut gibt man als Wert an, um welche Art von Variable es sich handelt, die zum Vergleich anstelle des Wertes aus dem Attribut "value" herangezogen wird. Wenn als Wert "global" angegeben wird, oder das Attribut nicht gesetzt ist, dann wird mit einer globalen Variablen verglichen. Wenn als Wert "request" angegeben wird, dann wird eine Request-Variable zum Vergleich herangezogen. Unter einer "Request-Variablen" versteht man eine Variable, welche entweder an die URL der Seite angehängt ist (seite.php?category=Film) oder per "get" bzw. "post" durch ein Formular an die Folgeseite übergeben wird. Wenn als Wert "sessionfield" angegeben wird, dann wird mit einer Sessionvariablen der Kundenverwaltung verglichen. Wenn als Wert "document" angegeben wird, dann wird mit einer Dokumenten-Variablen verglichen. Eine Dokumenten-Variable ist in der Regel ein Element, welches z.B. mit <we:input> eingegeben wurde. Wenn als Wert "now" angegeben wird, dann kann man ein Datumsfeld mit dem aktuellen Zeitpunkt vergleichen. Wenn als Wert "today" angegeben wird, kann man ein Datumsfeld mit dem aktuellen Datum vergleichen.
ab Version | 2.2.0.0 |
Typ | string |
mögliche Werte | global, request, sessionfield, document, now, today |
Standardwert | - |
Bei diesem Attribut gibst Du an ob in dem Attribut var eine Eigenschaft des webEdition-Dokuments für den Vergleich verwendet werden soll. Mögliche Einträge in var sind:
DocType, Category, IsSearchable, Extension,IsDynamic, ParentID, ParentPath, Text, Filename, Path, Owners, OwnersReadOnly, CreatorID, ModifierID, RestrictOwners
Kleiner Version 9: CreationDate, ModDate, Published
Ab Version 9: Creation_Date,Mod_Date und Publish_Date
ab Version | 2.2.0.0 |
Typ | boolean |
mögliche Werte | true, false |
Standardwert | false |
Wenn Du als Wert dieses Attributs "self" angibst, bezieht es sich auf das aktuelle webEdition-Dokument. Handelt es sich dabei um ein webEdition-Dokument, welches in ein anderes eingefügt wird (siehe <we:include />), so wird ein Bezug auf das eingefügte webEdition-Dokument hergestellt. Wenn Du als Wert dieses Attributs "top" angibst oder das Attribut nicht setzt, dann bezieht es sich auf das Haupt-webEdition-Dokument, auch wenn es sich dabei um ein webEdition-Dokument handelt, welches in ein anderes eingefügt wird (siehe <we:include />).
Wird das Tag innerhalb einer verwendet und das Attribut auf "listview" gesetzt, wird die ID der Seite, auf die der <we:listview /> verweist, ausgegeben.
ab Version | 1.3.0.0 |
Typ | string |
mögliche Werte | top, self, listview |
Standardwert | top |
ab Version | 6.1.0.0 |
Typ | boolean |
mögliche Werte | true, false |
Standardwert | false |
Bestimmt wie / wohin die Ausgabe erfolgt. Dabei wird der Code, der sonst auf der Seite ausgegeben würde, in exakt derselben Weise an die auszuwählende Variable übergeben. Dies ist eine praktische Alternative zu <we:setVar>, bitte vergleiche und entnimm weitere Details zu den einzelnen möglichen Werten dort.
Ab webEdition 6.1.0.2: post
, get
Ab webEdition 9.0.8: local
: Erlaubt den Wert einer lokalen Variable zuzuordnen und dann im Tag attribut="$name"
zu nutzen.
ab Version | 6.1.0.0 |
Typ | string |
mögliche Werte | screen, request, post, get, global, local, session, top, self, sessionfield |
Standardwert | screen |
Name der Variable, in die die Ausgabe erfolgt.
Ab webEdition 6.3.7 können auch Arrays mit folgender Syntax geschrieben werden werden:
<we:xxxx to="global" nameto="meinArray[abc]"/>
oder<we:xxxx to="global" nameto="meinArray[]"/>
oder<we:xxxx to="global" nameto="meinArray[][def]"/>
.
Wichtig ist hierbei, dass innerhalb der eckigen Klammern keine Hochkommata oder Anführungszeichen genutzt werden!
ab Version | 6.1.0.0 |
Typ | string |
Standardwert | - |
Syntax
<we:conditionAdd field="" value="" compare="=|!=|<|>|<=|>=|like|not like" var="" type="global|request|sessionfield|document|now|today" property="true|false" doc="top|self|listview" exactmatch="true|false" to="screen|request|post|get|global|local|session|top|self|sessionfield" nameto=""/>
Beispiele
Beispiel #1
<we:condition name="cond"> <we:conditionAdd field="Veranstaltungsort" type="request" var="ort" compare="="/> <we:conditionAnd/> <we:conditionAdd field="weVersion" var="Datum" type="now" compare=">"/> </we:condition>
Beispiel #2 - Dokumente aus einem Verzeichnis ausschließen
Um ein Verzeichnis auszuschließen, kann folgende Condition genutzt werden.
Diese Condition berücksichtigt keine Unterverzeichnisse.
Als value wird die ID des Verzeichnisses eingefügt.
<we:condition name="cond"> <we:conditionAdd type="global" property="true" field="we_ParentID" compare="!=" value=" " /> </we:condition>
Beispiel #3 - Objekte nach dem Inhalt eines Multiobject-Feldes selektieren
Um Objekte aufgrund des Inhaltes eines Multiobject-Feldes zu selektieren kann folgende Condition verwendet werden
Code<we:condition name="cond"> <we:conditionAdd field="Location" value="99,122" compare="like" /> </we:condition>
Hilf mit!
Hast Du eine Ergänzung für die Tag-Referenz, dann werde bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder
einfach formlos per E-Mail an
websites@webedition.org.
Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.