# INSERTDATA
#### Syntax
**INSERTDATA**(table)
* *table* - ein Tabellen-Widget, das die Datensätze enthält, die in die Datenquelle eingefügt werden sollen - ***Wertetyp**: Tabellen-Widget*
#### Bemerkungen
* *table* muss ein Tabellen-Widget sein, dem eine Datenbankverbindung zugewiesen ist, mit den folgenden Informationen:
* eine Verbindung zu einer relationalen Datenbank
* eine Datenbanktabelle
* die Datenbankspalten, die beim Zurückschreiben mit berücksichtigt werden sollen. Wenn Spalten nicht mit angegeben werden, so werden diese beim Zurückschreiben nicht geändert, bzw. mit "null" gefüllt, wenn der Datensatz neu angelegt wird.
* Schlüsselspalten sollten mit der Eigenschaft „Key“ gekennzeichnet sein.
* Die Datensätze werden wie folgt eingefügt bzw. geändert:
* Wenn es bereits einen Datensatz mit den angegebenen Schlüsselspaltenwerten in der Datenbanktabelle gibt, wird der vorhandene Datensatz überschrieben.
* Wenn nicht, wird der Datensatz als neuer Datensatz der Datenbank-Tabelle hinzugefügt.
* Wenn keine Schlüsselspalte angegeben wird, werden immer alle Datensätze hinzugefügt.
* Das Widget, welches die INSERTDATA Funktion ausführt, muss nicht mit der Datenquelle verbunden sein.
#### Beispiele
*Beispiel 1 - Ändern der gesamten Datenbanktabelle*
Die Tabelle *WineList* wird mit der Funktion GETDATA gefüllt und zeigt die Daten aus der Datenbanktabelle *WineList*. Die Spalte *Name* hat die Eigenschaft „Schlüsselspalte“.
Wenn der Inhalt dieser Tabelle geändert werden soll, genügt ein einziger Aufruf der Funktion INSERTDATA, wobei die Tabelle als Parameter verwendet wird.
*Beispiel 2 - Hinzufügen eines einzelnen Datensatzes*
Der Inhalt der Datenbanktabelle aus Beispiel 1 kann auch durch ein anderes Tabellen-Widget geändert werden. In diesem Beispiel soll ein einzelner neuer Datensatz hinzugefügt werden. Dazu sollten die Einstellungen der zweiten Tabelle im Tab *Connection* die gleichen sein wie bei der Tabelle *WineList*.
Bitte beachten, dass hier die zweite Tabelle nicht mit der Funktion GETDATA gefüllt wird. Diese kann stattdessen mit beliebigen Datensatz-Inhalten befüllt werden, z.B. manuell oder über andere Formeln.
Nun können einzelne oder mehrere Datensätze hinzugefügt oder geändert werden, indem Sie auf die Schaltfläche *addWine* klicken.
*Beispiel 3 - Einzelne Werte ändern oder hinzufügen*
Wenn nur ein einziger Wert für einen Datensatz hinzugefügt oder geändert werden soll, müssen die anderen Datenbankspalten nicht angegeben werden.
