Die Funktion $el wird dazu verwendet, Daten von einem Formularelement zu lesen. Als Parameter wird die ID des Elements übergeben.
Optional können auch die Daten sämtlicher Duplikate als Liste angefordert werden (siehe Parameterbeschreibung von duplicatesToo).

Tipp: Die Funktion $el kann automatisch mit der korrekten Element-ID eingefügt werden, indem das Verknüpfungssymbol unterhalb des Ausdruck-Eingabefeldes angeklickt wird. Danach kann das beliebige Element einfach via Klick im Formular ausgewählt werden.

Syntax

$el(elementId[,duplicatesToo=false])

Parameter

Name

Beschreibung

elementId

Die ID des gewünschten Formularelements

duplicatesToo
(Standard: false)

Ein optionaler Parameter welcher angibt, ob die Werte aller Duplikate des angegebenen Elements als Liste zurückgeliefert werden sollen.
Duplikate eines Elements sind beispielsweise Instanzen in einem "Wiederholendes Element" Container.

Wird $el in einer Berechnung ausgeführt, welches sich innerhalb eines wiederholten Elements befindet, so kann dieser Parameter auch weggelassen oder auf false gesetzt werden, um den Wert eines Elementes in der selben wiederholenden Hierarchie zu lesen.

Rückgabewert

Gibt den Wert des Elements mit der übergebenen ID zurück oder null wenn der Wert des Elements leer oder das Element nicht vorhanden ist.
Mit dem Parameter duplicatesToo=true wird eine Liste der Werte aller Duplikate des übergebenen Elements zurückgegeben.

Beispiel

Eine kleine Maske mit einem "Wiederholendes Element" Container und zwei Knöpfen soll Demonstrieren, wie die Funktion $el eingesetzt werden kann.

images/download/attachments/62863814/elFunctionExample-version-1-modificationdate-1610638756632-api-v2.png

Der Knopf "Lese alle Textfelder" soll die Werte aller wiederholten Textfelder (Element-ID 5) lesen und mit einem Zeilenumbruch separiert voneinander in einer Hinweisbox ausgeben.
Hierfür wird die Hilfsfunktion $concatWS(separator, ... liste) verwendet, welche in einem Separaten Handbuchkapitel beschrieben ist.
Um die Werte sämtlicher duplizierter Textfeldinstanzen als Liste zu lesen, wurde der Parameter duplicatesToo auf true gesetzt.

Der Button mit der Aufschrift "Lese Textfeld" hingegen liest nur den Wert des "eigenen" Textfeldes, welches sich mit ihm in der selben Zeile befindet. Der Parameter duplicatesToo wurde hierfür nicht übergeben und ist daher standardmäßig false.

Ergebnis der Konfiguration

Gestartetes Formular	Klick auf "Lese alle Textfelder"	Klick auf "Lese Textfeld" (zweite Zeile)