INSERTDATA

Schreibt Daten in eine Datenbank-Tabelle.

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.