concat fields within same node(a,b,c,d)


Fügt alle Felder aneinander, die innerhalb des gleichen Knotens und oberhalb des aktuellen Feldes existieren, jeweils getrennt durch Trennzeichen a. Sollte das Trennzeichen bereits im Feldtext vorhanden sein wird das Zeichen im Text mit \ escaped.

Berechnungsfelder, Unterknoten sowie das Feld selbst, auf dem diese Funktion gesetzt ist, werden ignoriert. Wenn der optionale Parameter b den Wert true hat, werden Berechnungsfelder mit aufgenommen.

Parameterbeschreibung


Parameter

Beschreibung

a

(optional) Trennzeichen für die einzelnen Werte. Beginnt der Text mit 0x, wird das Unicodezeichen mit dem folgenden hexadezimalen Wert verwendet. Siehe Beispiele unten. Default: ,

b

(optional) Bei true werden Berechnungsfelder mit aufgenommen. Bei false werden Berechnungsfelder ausgeblendet. Default: false.

c

(optional) Ist false gesetzt und hat ein Feld ein gesetztes Empty Flag, dann verwendet die Funktion den versteckten Wert des Feldes. Bei true wird stattdessen ein String aus Leerzeichen verwendet, dessen Länge der Feldlänge entspricht (→ siehe Beispiele). Default: false.

d

(optional) Zeichen/String zum Maskieren des Trennzeichens, wenn dieses innerhalb der Feldwerte vorkommt. Default: \

Beispiele


Der Zielknoten DestNode soll die folgende fünf Felder mit folgenden Werten enthalten und darunter ein Feld, das die hier beschriebene Funktion enthält.


Counter (Berechnungsfeld)

Feld1

Feld2

Feld3

Feld4 (String-Feld der Länge 3)

1

Wert1

Wert2

Wert3

<no value> ('')

Parameter a

Parameter b

Parameter c

Parameter d

Ergebnis

;




Wert1;Wert2;Wert3;

;

true



1;Wert1;Wert2;Wert3;

0x20

false



Wert1_Wert2_Wert3_ (Das Leerzeichen wird hier zu Darstellung als Unterstrich gezeigt)

0x20

false

true

Wert1_Wert2_Wert3____ (Das Leerzeichen wird hier zu Darstellung als Unterstrich gezeigt)