# bx:recordfield
Das Tag `recordfield` stellt ein einzelnes Element eines Container-Datensatzes dar. Dies kann ein simpler Typ wie z.B. Text, Datum oder Bild, aber auch eine Schleife über Untercontainer sein.
## Allgemeine Syntax
```xml
Inhalt
```
Je nach Feld-Typ stellt sich bx:recordfield unterschiedlich dar und akzeptiert verschiedene Parameter.
### field
Name des Feldes im Container
### level
`level=".."` - übergeordneter Container
Zugriff auf die Felder des übergeordneten Containers (zur Zeit nur direkt-übergeordnet möglich). Sollte nicht mehr verwendet werden, lieber `parent`
### baseloop
Name der Containerschleife (wie er nach dem Punkt im Tag steht)
Bezug auf eine bestimmte Containerschleife (z.B. bei Verschachtelungen)
### parent
- `parent`: Zugriff auf direkt übergeordneten Container
- `parent="2"`: Zugriff auf n-ten übergeordneten Container
### dummy
bewirkt, daß, wenn noch kein DS verknüpft ist, ein neuer DS erzeugt wird. Dazu darf beim Speicher-Action weder ja noch nein bei createnew gewählt sein.
### Beispiele
```xml
">
```
Linkaufruf mit Übergabe der Kategorie in der inneren Schleife. Zugriff auf die Kategorie-ID mit `baseloop`.
```xml
&anbieter=">
```
Ähnliches Beispiel wie oben mit zusätzlicher Ebene. Zugriff auf die Kategorie-ID und die Anbeiter-ID mit `parent`.
## Filter
```xml
```
Bei einfachen Typen (Text, Datum, Zahl, Wahrheitswert) lassen sich auch JSP-Filter einsetzen.
Die Schnittstelle zum Filter bildet das Request-Attribut "attrValue". Über dieses wird dem Filter der Inhalt des Tags übergeben und aus diesem wird nach dem Filteraufruf auch der neue Tag-Inhalt gelesen.
### filter
Angabe eines Filters (direkt über JSP-Baustein)
### dynamicfilter
Angabe eines Feldes im Datensatz, wo der Name des Filters drin steht (dynamisch)
### quiet
Fehler werden nicht auf der Seite ausgegeben
### Beispiele für Filter
**Filtername im Feld**
```xml
...
Preis ohne MWSt.:
Preis incl. MWSt:
...
```
Innerhalb des Filters "Bruttopreis" wird der (Netto)Preis in Bruttopreis umgerechnet und anstelle des Wertes im Recordfield ausgegeben.
**Filtername aus Container**
```xml
...
Preis ohne MWSt.:
Preis incl. MWSt:
...
```
Gleiches Beispiel wie oben, nur daß der Filtername (also Bruttopreis) im Feld "Filter" steht und von dort genommen wird. Vorteil: es kann pro DS ein völlig anderer Filter bestimmt werden.
## einzeiliger Text
```xml
```
Je nach Feld-Typ stellt sich bx:recordfield unterschiedlich dar und akzeptiert verschiedene Parameter.
### encode | type
Der Text wird (falls gewünscht umgewandelt) ausgegeben.
- **Standard:** [htmlencode](/books/cms-handbuch-entwickler/page/bx-tools)
- **quoted-printable:** das Format in einer Email, siehe entsprechenden Wikipedia-Eintrag
- **javascript:** Den Zeichen `\n \r \t " ' \"` wird ein Backslash vorangestellt.
- **url:** zum Kodieren von Request-Parametern. Es wird java.net.URLEncoder benutzt.
- **urlpath:** zum Kodieren von Pfadbestandteilen (z. B. Dateiname)
- **plain:** unformatierter Text
- **csvfield:** (ab v2.5.9) der Text wird mit `"` umgeben und allen `"` im Text wird ein zusätzliches `"` vorangestellt
### maxwords
nur eine bestimmte Anzahl an Wörtern ausgeben
### maxchars
nur bestimmte Anzahl Buchstaben ausgeben
### ellipsis
Ohne Parameter: fügt "..." an den Text an, wenn dieser abgeschnitten wurde.
`ellipsis=" usw."` (mit Parameterwert) fügt "usw." an den Text an (oder einen anderen beliebigen Text).
### Feldinhalt vergleichen
```xml
Inhalt Inhalt Inhalt
```
Der Inhalt des Tags wird nur dann angezeigt, wenn der Inhalt des Container-Feldes mit den Testkriterien übereinstimmt (umkehrbar mit `not`).
#### matches
Regulärer Ausdruck
auf "leer" prüfen: `matches="^$"` (Achtung: es wird immer der gesamte String verglichen, "^" vor und "$" nach dem Ausdruck sind also implizit!)
#### equals
String, der mit dem Feldinhalt übereinstimmen muß
#### contains
String, der im Feldinhalt enthalten sein muß
### Beispiele
```xml
keine gültige E-Mail-Adresse
```
**Achtung:** `matches` funktioniert nicht oder nicht korrekt wenn RegEx-Sonderzeichen wie Klammern, „+“ „?“, „*“ im Request stehen
Mit equals funktioniert es dann:
```xml
```
Innerhalb einer Schleife: wenn übergebener Wert des Parameters `param` mit dem Kategorienamen übereinstimmt, wird dieser DS vorausgewählt.
```xml
class="intern"
```
Jedem Link, der den String "batix.com" enthält, wird die Klasse "intern" zugewiesen (um ihn z.B. auf www.batix.com von externen Links zu unterscheiden)
## mehrzeiliger Text
```xml
```
### csv
(veraltet, siehe encode | type)
### encode | type
Der Text wird (falls gewünscht umgewandelt) ausgegeben.
- **Standard:** [htmlencode](/books/cms-handbuch-entwickler/page/bx-tools)
- **quoted-printable:** das Format in einer Email, siehe entsprechenden Wikipedia-Eintrag
- **javascript:** Den Zeichen `\n \r \t " ' \"` wird ein Backslash vorangestellt.
- **csv:** alle Zeilenumbrüche durch Leerzeichen ersetzt und sonstige Steuerzeichen entfernt.
- **plain:** unformatierter Text
- **csvfield:** (ab v2.5.9) der Text wird mit `"` umgeben und allen `"` im Text wird ein zusätzliches `"` vorangestellt
- **url:** gibt es für dieses Tag nicht, man kann bx:tools.urlencode drumrum machen
- **htmltext:** zeigt plain-Feld in Verwaltung aber macht ` `s im Frontend rein
### maxwords
nur eine bestimmte Anzahl an Wörtern ausgeben
### maxchars
nur bestimmte Anzahl Buchstaben ausgeben
### ellipsis
Ohne Parameter: fügt "..." an den Text an, wenn dieser abgeschnitten wurde.
`ellipsis=" usw."` (mit Parameterwert) fügt "usw." an den Text an (oder einen anderen beliebigen Text).
### Beispiele
```xml
mehr
```
Anteasern in einer Liste: es sollen max. 20 Wörter ausgegeben werden, dann wird ein ... gesetzt.
## Datum/Zeit
```xml
```
### locale
Sprachformatierung (z.B. "de" oder "en_US")
`locale` sollte immer angegeben werden, da sonst die Standardeinstellung vom Server genutzt wird, die sich aber nach Updates oder Umzügen ändern kann.
### pattern
Formatierung des Datums (Standard für Datum / Datum+Zeit / Zeit ist "EEEEEE, d. MMMMMM yyyy" / "dd.MM.yyyy HH:mm" / "HH:mm")
### year / month / day / minute / second
Datum direkt setzen oder das aktuelle Datum manipulieren.
Folgende Angaben bei `{mod}`:
- **n:** das entsprechende Feld wird auf den Wert n gesetzt
- **+n:** das entsprechende Feld wird um den Wert n erhöht
- **-n:** das entsprechende Feld wird um den Wert n verringert
- **Achtung:** Monate laufen von 0-11
### type="holiday"
prüft, ob der Tag auf einen Feiertag fällt und schreibt statt des Datums die Feiertagsbezeichnung hin (z. B. Silvester)(ab V2.6.0)(Thüringer Feiertage)
### Beispiele
```xml
```
zeigt anstatt des gespeicherten Datums den 15. des folgenden Monats an.
### Abfrage
```xml
Inhalt
```
Mittels dieser Variante wird *Inhalt* nur ausgegeben wenn das Datum im Datensatz (inklusive eventueller Modifikationen) in der Vergangenheit liegt (`past`), in der Zukunft liegt (`future`) oder leer ist (`empty`). `not` kehrt die Bedingung um.
### Beispiele
```xml
Herzlichen Glückwunsch zum Geburtstag!
```
Das Feld Geburtsdatum wird mit dem heutigen Datum verglichen. Da das Jahr ja nicht stimmt, wird es auf das aktuelle Jahr gesetzt und kann nun verglichen werden.
### Datumsmanipulation
```xml
```
mo", "di", "mi", "do", "fr", "sa", "so" oder "mon", "tue", "wed", "thu", "fri", "sat", "sun" wechselt auf den entsprechenden Wochentag, der Woche in dem das Calendar-Objekt ist.vorangestelltes Plus- oder Minuszeichen wechslet zum folgenden bzw. vorigen entsprechenden Wochentag. Wenn calendar bereits auf dem gleichen Wochentag steht, wird nichts geändert. Dieser Fall wird mit doppelten plus/minus anders behandelt. Dann wird nämlich +/-7 Tage gerechnet.
Vom gespeicherten Wert aus können folgende Werte ermittelt werden:
### weekday
- **Do** = der Donnerstag dieser Woche (egal ob schon vergangen oder nicht)
- **+Do** = der nächste Donnerstag (heute, falls heute Donnerstag)
- **-Do** = der vorige Donnerstag (heute, falls heute Donnerstag)
- **++Do** bzw. **--Do** = der nächste/vorige Donnerstag (nie heute)
## Zahl/Preis
### Formatierte Ausgabe
```xml
Inhalt
```
#### locale
Sprachformatierung (z.B. "de" oder "en_US")
#### pattern
Formatierung festlegen, (Standard bei Zahl: "0.#####", bei Preis: "0.00", bei Preis mit Tausenderpunkt: "#,##0.00")
#### gs
Tausender-Trennzeichen festlegen
#### ds
Dezimal-Trennzeichen festlegen
#### isempty
Abfrage, ob das Feld leer ist
### Abfrage des Betrages
```xml
Inhalt
```
(Ausgabe von Quelltext abhängig vom Zahlenwert)
#### equals
Vergleich des Feldinhalts mit einem Wert. Ausgabe bei Übereinstimmung
#### true, false
eingetragener Text wird bei Übereinstimmung bzw. Nicht-Übereinstimmung ausgegeben.
```xml
Inhalt
```
Zahl mit einem Wert vergleichen. Ausgabe bei Übereinstimmung.
Ab *Version 2.5.7* kann anstatt der festen Vergleichszahl für ` {n}` auch "`request:{Parametername}`", "`attribute:{Attributname}`" oder "`clipboard:{Name}`" verwendet werden.
#### gt / gte / lt / lte
- **gt:** größer
- **gte:** größer gleich
- **lt:** kleiner
- **lte:** kleiner gleich
### Alternativwert
```xml
Anzahl fehlt oder ist 0
```
Ab *Version 2.5.8* kann der Parameter `alt` verwendet werden um einen Alternativwert zu verwenden, falls keine Zahl gespeichert ist (auch keine 0).
```xml
```
Ab *Version 2.5.8* kann der Parameter `alttext` verwendet werden um einen Alternativtext anzuzeigen, falls keine Zahl gespeichert ist (auch keine 0).
Dies kann z. B. auch für Intranet-Eingabeseiten verwendet werden, um zu markieren wo Zahlenwerte leer sind.
## Wahrheitswert
```xml
Inhalt Inhalt Inhalt Inhalt
```
Zusätzlich zu den beiden Statussen "j" und "n" also true und false, gibt es noch den Status "empty". Diesen Status hat das Feld, wenn es noch nie ausgewählt wurde (im Backend wurde beim Speichern des DS keine Feld mit dem entsprechenden Namen übergeben) oder wenn im Container direkt dieser Status ausgewählt wurde (siehe Bild "Datenansicht").
Ob dieser Status "nicht gewählt" erlaubt ist, kann in der Containerdefinition festgelegt werden. Dort kann auch ein Wert den entsprechenden Statussen zugewiesen werden (Felder "angezeigter Text...".
| | |
| --- | --- |
| Definitionsansicht:  | Datenansicht:  |
### not
Ausgabe, wenn das Feld nicht angehakt wurde (ohne: Ausgabe, wenn das Feld angehakt wurde)
Veraltet für `not`: invert und else
### empty
Ausgabe, wenn Status "nicht gewählt" zutriffe (Erklärung siehe Text oben)
### Beispiele
```xml
Infomaterial gewünscht
kein Infomaterial gewünscht
Du hast dich bereits entschieden.
```
Das Feld "Infomaterial_gewuenscht" kann nur einmal ausgewählt werden und dann nie wieder.
```xml
```
Eine Ausgabe entspechend des gespeicherten Statuses erfolgt.
### true
Text, der ausgegeben wird, wenn das Feld angehakt wurde
### false
Text, der ausgegeben wird, wenn das Feld nicht angehakt wurde
### empty
Text, der ausgegeben wird, wenn das Feld den Status "nicht ausgewählt" hat (Erklärung siehe oben)
### show
ab V 2.6.2: `real` gibt den wirklich gespeicherten Wert (z.B. "j", "n", "1", "0") aus; `config` gibt den in der Verwaltung konfigurierten Wert aus (Standard: "wahr", "falsch")
Bisher gab es noch keine Option um zu sagen „nicht angehakt oder leer“ bzw. „angehakt oder leer“.
```xml
...
```
| | `` | `` | `` | `` | `` | `` |
| --- | --- | --- | --- | --- | --- | --- |
| angehakt | angezeigt | | | angezeigt | | angezeigt |
| nicht angehakt | | angezeigt | | angezeigt | angezeigt | |
| leer | | | angezeigt | | angezeigt (wenn alt="false") | angezeigt (wenn alt="true") |
| einen der drei Werte abfragen | Gegenteil(die beiden anderen Möglichkeiten) |
| --- | --- |
| `` zeigt Block an, wenn das Feld angehakt ist | `` zeigt Block an, wenn das Feld nicht angehakt oder leer ist |
| `` zeigt Block an, wenn das Feld als nicht angehakt gespeichert ist | `` zeigt Block an, wenn das Feld angehakt oder leer ist |
| `` zeigt Block an, wenn das Feld leer ist | `` zeigt Block an, wenn das Feld als angehakt oder nicht angehakt gespeichert ist |
### Beispiele
```xml
...
Infomaterial gewünscht?
...
xml
...
```
## Bild
```xml
```
Es wird das Bild (also ein Tag) ausgegeben, ggf. verkleinert, wenn gewünscht.
### width
Angabe der max. Breite (abhängig von der Höhe)
### height
Angabe der max. Höhe (abhängig von der Breite)
### nogifshrink
keine Verkleinerung von GIF-Dateien
### cover
(ab V 2.6.3, ansonsten bei 2.6.2 reinkopieren)
Bild wird nur soweit verkleinert, daß es das angegebene Element ganz ausfüllt (siehe Beispiel 2)
### cover="crop"
Originalbild wird abgeschnitten und auch so gespeichert
### Beispiele
**Beispiel 1**
```xml
" alt="">
```
Bild wird in den genannten Dimensionen ausgegeben. Es wird entweder auf die Breite oder Höhe verkleinert.
**Beispiel 2**
```xml
css:
.qimg{
width:150px;
height:150px;
overflow:hidden;
border:1px solid black;
background-position:center;
}
______________________
');">
```
Bild wird deckend in den genannten Dimensionen ausgegeben. Es wird entweder in der Breite (bei Querformt) oder in der Höhe (bei Hochformat) beschnitten.
Unterschied: siehe Bild, halbtransparente Bildteile werden durch css abgeschnitten
### Bild-Daten ausgeben
```xml
```
#### type
Statt des eigentlichen Bildes kann folgendes ausgegeben werden:
- **path:** relativer Pfad
- **url:** komplette URL
- **title, name:** Titel des Bildes (Metadaten, Eingabe unter "Grafiken")
- **originalname:** Originaldateiname vom Upload
- **licence:** Lizenzangabe
- **description:** Beschreibung des Bildes
- **alt:** Alternativtext des Bildes (Metadaten, Eingabe unter "Grafiken")
- **author:** Autor des Bildes (Metadaten, Eingabe unter "Grafiken")
- **empty:** Abfrage, ob Feld leer ist (ab v 2.6.2)
- **id:** ID in der Bildergalerie (ab v 2.6.2)
- **inline:** erzeugt img-Tag mit Binärdaten in src (ab 2.6.1), sinnvoll bei Newsletter, da steht das Bild direkt in der Seite, also nicht als Link oder Anhang
- **base64data:** Tagerweiterung für vcf (Outlook-Visitenkarte, siehe Beispiel 2) mit Foto ab v2.6.6
#### not
in Verbindung mit empty, kehrt die Abfrage um
### Beispiele
```xml
');" title=""> Inhalt
```
Anzeige als Hintergrundbild, aber nur, wenn auch ein Bild vorhanden ist.
```xml
BEGIN:VCARD
VERSION:2.1
N:;;;;
FN:PHOTO;
ORG:;
TITLE:
NOTE;ENCODING=QUOTED-PRINTABLE:
contact=0D=0A
TEL;WORK;VOICE:TEL;HOME;VOICE:TEL;CELL;VOICE:TEL;WORK;FAX:
ADR;WORK:;;;;;;
LABEL;WORK;ENCODING=QUOTED-PRINTABLE:=0D=0A, =0D=0A
URL:
EMAIL;PREF;INTERNET:
REV:
END:VCARD
```
Erzeugung einer Visitenkarte für Outlook
### Bild-Größenangaben ausgeben
```xml
```
Hier werden nur die Größen als Zahl ausgegeben (z.B.: für Javascript-Popups um die Größe zu übergeben).
#### origwidth
Ausgabe der Originalbreite
#### origheight
Ausgabe der Originalhöhe
#### calcwidth
Ausgabe der (berechneten) Endbreite
#### calcheight
Ausgabe der (berechneten) Endhöhe
## Dokument
```xml
Inhalt
```
Falls `type` nicht angegeben wurde, wird der Standardwert `link` verwendet.
### type
- **link:** erzeugt einen klickbaren Link auf das Dokument (falls Inhalt angegeben, wird dieser als Linktext verwendet)
- **path:** gibt den relativen Pfad
- **url:** gibt die komplette URL aus
- **id:** gibt die ID aus
- **name:** gibt den Namen aus
- **size:** gibt die Dateigröße aus
- **description:** gibt die Beschreibung aus
- **meta:** Metadatenabfrage, Name des Meta-Feldes wird mit `name` übergeben (siehe unten)
- **empty:** (ab V 2.6.2) Abfrage, ob Feld leer ist
### name
(nur in Verbindung mit `type="meta"`) Name der Meta-Eigenschaft
### unit
(nur in Verbindung mit `type="size"`)
- **auto:** wählt automatisch die entsprechende Einheit, je nach Größe der Datei
- **b:** Angabe in Byte
- **kb:** Angabe in Kilobyte
- **mb:** Angabe in Megabyte
### pattern
(nur in Verbindung mit `type="size"`) Formatierung der Zahl (Standardwert ist "#,##0")
### locale
(nur in Verbindung mit `type="size"`) Sprachen-Formatierung der Zahl (standardmäßig "de_DE")
### disposition
siehe Beispiele
### Beispiele
```xml
```
Ausgabe: `http://domain/files/{Batix-ID}/{Dateiname}
`setzt content-disposition:inline; filename=“{Dateiname}“, wird als Standard genommen, wenn nichts angegeben wird
```xml
```
Ausgabe:`http://domain/files/download/{Batix-ID}/{Dateiname} `
bewirkt bei PDFs einen Zwangsdownload anstatt eine Anzeige im Browser-Plugin, dasselbe auch durch `http://domain/files/{Batix-ID}/{Dateiname}?dl=true`
```xml
```
Ausgabe: `http://domain/files/media/{Batix-ID}/{Dateiname}
`bewirkt bei MP4-Videos, die in Apple-Mobilgeräten abgespielt werden sollen, daß das funktioniert, weil der Header nicht geschrieben wird (scheint nur Apple-Geräte zu betreffen)
## Pixelkoordinaten
```xml
```
### type
Je nach `type` wird entweder die x- oder die y-Koordinate ausgegeben
### multiply
Angabe zum Multiplizieren des Koordinatenwertes (bei Kartenvergrößerung bzw. -verkleinerung)
### add
Wert, der zum Koordinatenwerte dazuaddiert werden kann
### alt
Alternativwert, der ausgegeben wird, wenn keine Zahl festgelegt ist
## Einfachverknüpfung
```xml
> Inhalt >
/>
> Inhalt >
```
Innerhalb des Tags kann wiederum mittels `bx:recordfield` auf die Elemente der Verknüpfung zugegriffen werden.
Falls kein Vergleich passt, wird der Inhalt nicht ausgegeben.
Falls kein Inhalt angegeben ist, wird der Titel des Datensatz-Feldes ausgegeben.
### chkuser
ID des Datensatzes mit der User-ID des aktuell eingeloggten Users bzw. mit den IDs seiner Gruppen verglichen.
### type="id"
gibt die ID des Datensatzes aus
### type="if"
(ab V *2.5.8*) Inhalt des Tags wird nur dann angezeigt, wenn die ID des verknüpften Datensatzes mit der in `value` angegebenen übereinstimmt
### value
zu prüfende ID. Mehrere zu prüfende IDs können durch Leerzeichen oder Kommas getrennt werden.
- **#null:** "nichts verknüpft" wird abgefragt
- **#all:** hebt alle Bedingungen auf, zeigt alles an (siehe Beispiel)
### not
kehrt die Bedingung um
### show
- **active:** nur aktive DS (Standard)
- **inactive:** nur inaktive DS
- **all:** aktive und inaktive DS werden angezeigt
### Beispiele
**Beispiel für den Einsatz von nofilter**
```xml
#alleine Kategorieid...
```
Clipboard wird mit `#all` initialisiert
Clipboard wird mit einer ID gefüllt oder auch nicht
wenn nicht gefüllt, greift das #all und hebt alle Bedingungen auf (`ID` = gibt aus, wenn es diese ID ist, `#null` = gibt aus, wenn nichts verknüpft ist) und gibt bei jedem DS aus
##
## Mehrfachverknüpfung
```xml
Inhalt
```
Hier stellt sich bx:recordfield als Schleife dar, welche für jeden Unter-Datensatz durchlaufen wird.
### forceindex
Stelle, an der die Ausgabe beginnen soll
### indexparam
Parametername, wo die Stelle, an der die Ausgabe beginnen soll, steht
### max
maximale Anzahl der auszugebenden Datensätze (z.B. max="5")
### idfield
Parametername, der die ID des Datensatzes enthält (Standard ist der Name des Feldes)
### force
Ausgabemodus (single oder list) kann erzwungen werden
### orderby
Feldangabe, nach der die Ausgabe sortiert sein soll (Datum, Name etc.)
### desc
dreht die Sortierrichtung um
### chkuser
DS-ID und ID seiner zugeordneten Gruppen wird mit der ID des eingeloggten Users verglichen, d.h.: Wenn im DS eine Gruppe zugeordnet ist, dann wird der Inhalt ausgegeben
### type
quantity: Anzahl der verknüpften Datensätze anzuzeigen
### boundary
Trennzeichen, wenn die Titel aller Elemente ausgegeben werden (Standard ","); sollen nur die IDs ausgegeben werden, muss `type="ids"` angegeben werden (Tag ohne Inhalt)
### show
auch inaktive anzeigen lassen ab v2.6.6
***Erweiterung für neue Container (v2.5.8)* Werte für `type`:**
```xml
... Inhalt
```
| type= | ids | gibt die verknüpften ID's mit Leerzeichen getrennt aus |
| --- | --- | --- |
| | titel | gibt zur Zeit den Titel aus z. B. "2 verknüpfte Datensätze" (Standard wenn type nicht angegeben und geschlossenes Tag) |
| | quantity | gibt die Datensatzanzahl aus. "0" wenn keine Datensätze verknüpft |
| | if-any | gibt den Inhalt aus, wenn ein verknüpfter Datensatz die angegebene ID hat |
| | if-none | gibt den Inhalt nur aus, wenn keiner der verknüpften Datensätze die angegebene ID hat |
| | if-all | gibt den Inhalt aus, wenn alle angegebenen IDs im Datensatz verknüpft sind |
| | if-empty | gibt den Inhalt aus wenn kein Datensatz verknüpft ist not: wenn mindestens 1 Datensatz verknüpft ist |
| | computebody | gibt eine Schleife für jeden verknüpften Datensatz aus (Standard, wenn type nicht angegeben und offenes Tag) Die Parameter von oben sind noch gültig (force, idfield, max, indexparame, orderby nofilter) |
| | chkuser | wenn das Feld eine BC-Verknüpfung ist, wird geprüft, ob es mit dem eingeloggten Benutzer/Gruppe übereinstimmt (wie bei if-empty) |
| boundary | | damit kann man den Trenner angeben, z.B. boundary="," Standard ist Leerzeichen |
| nosv | | wenn Admin, der ja in allen Gruppen drin ist, eingeloogt, wird er keiner Gruppe zugewiesen |
## Untercontainer
```xml
Inhalt >
Inhalt >
```
Dieser Typ ist der Mehrfachverknüpfung ähnlich. Für jeden Datensatz wird der Inhalt des Tags angezeigt. Ab *v2.5.?* gibt es die Möglichkeit einen Filter zu definieren, nach dem die Unterdatensätze gefiltert werden
### forceindex
Stelle, an der die Ausgabe beginnen soll
### indexparam
Parametername, wo die Stelle, an der die Ausgabe beginnen soll, steht
### max
maximale Anzahl der auszugebenden Datensätze (z.B. max="5")
### idfield
Parametername, der die ID des Datensatzes enthält (Standard ist der Name des Feldes)
### force
Ausgabemodus (single oder list) kann erzwungen werden
### orderby
Feldangabe, nach der die Ausgabe sortiert sein soll (Datum, Name etc.)
Sortierung nach Anlegereihenfolge: Angabe des Feldes, das die Parent-ID enthält
### desc
dreht die Sortierrichtung um
### nofilter
Filtereigenschaften werden nicht vom übergeordneten Container übernommen (siehe Beispiel unten)
### filterfield
gibt den Namen des Feldes im Untercontainer an, das durchsucht werden soll
### filtertype
Vergleichstyp (siehe [Filter](/books/cms-handbuch-entwickler/page/filter), standardmäßig auf 8 gestellt)
### filtervalue
Static-Wert oder [Parameter-Werte](/books/cms-handbuch-entwickler/page/parameter-werte)
### filterrequired
required-Flag für das Filter-Objektsetzen (standardmäßig false)
### type / not
- **empty:** Abfrage, ob der UK leer ist. `not` kehrt die Abfrage um
- **quantity:** gibt die Anzahl aus
### show
- **active:** nur aktive DS (Standard)
- **inactive:** nur inaktive DS
- **all:** aktive und inaktive DS werden angezeigt
### Beispiele
**Beispiel für eine Filterung des Untercontainers**
```xml
```
**Beispiel für den Einsatz von nofilter**
```xml
...
..
..
```
Filter für den Container "Kücheninhalt" (alle DS, die im UK "Lebensmittel" das Wort "brot" im Feld "Titel" enthalten).):
```xml
Lebensmittel/Titel1brot
```
Verhalten, wenn `nofilter` **nicht gesetzt** ist:
Bei Ausgabe des Recordfield "Lebensmittel" werden nur die DS, die im Titel "brot" enthalten, ausgegeben, da der Filter vom Containerfilter übernommen wurde. `nofilter` verhindert das und alle DS werden ausgegeben.
## Veraltete Tags
Die folgenden Befehle sind veraltet und werden durch bx:recorddata ersetzt.
```xml
```
Verweise auf diese Seite:
- Container-Filteraction
- bx:tablefield
- Container
- bx:recordfield
- Container
- bx:tablefield
- Container-Filteraction
- bx:recordfield