====== #sqlparam# ======

Leitet die Definition der SQL-Paramter ein. Mit den SQL-Parametern können Parameter für die SQL-Abfrage aus dem Flex-Formular übernommen werden.

Der Parameter wird über die ID des Steuerelements vergeben, oder es wird ein Wert angegeben.

===== SQL-Parameter aus Listen =====


Wird der Parameter von Listen-Steuerelementen abgefragt, dann gibt es zwei Varianten, wenn in der Liste 'alle' gewählt ist:

  1. Übergabe eines Strings, mit einer Liste der gewählten Elemente.
  2. Übergabe der gewählten ID, bzw. -1 für alle
  
Soll nur die ID Zurückgeben werden, dann muss dem SQL-Paramter die Endung .ID angehängt werden. 
===== Syntax =====

<code>
#sqlparam#
<paramter>;<Datentyp>;<ID des Steuerelements>
<paramter>;<Datentyp>;value:<wert>
</code>

Folgende Datentypen sind hinterlegt:

^ Datentyp ^ Beschreibung ^
| string, varchar, nvarchar | Zeichenfolgen |
| long, bigint | Ganzahlige Ausdrücke |
| double, float | Fließkommezahlen |
| boolean, bit | Ja-Nein-Werte |
| date, datetime | Datum / Zeitwerte |

===== Beispiel =====

<code>
#form#
iperson;person{
	layout
	}

#sqlcommanddef#
test

#sqldef#
insert into tabelle(wert)
values(@wert)

#sqlparam#
@wert;varchar;iperson
</code>

==== Beispiel, Übergabe eines Wertes ====

<code>
#sqldef#
select Datum, GruppenID, Ist 
from Umsätze
where year(Datum) = @Jahr

#sqlparam#
@Jahr;bigint;value:2013
</code>

==== Beispiel, Übergabe der ID bei einem Listen-Steuerelement ====

<code>

#form#
igruppe;liste_gruppe{
	caption: Gruppe
	alle
	}

#sqldef#
select Datum, GruppenID, Ist 
from Umsätze
where year(Datum) = @Jahr

#sqlparam#
@Jahr;bigint;igruppe.id
</code>