Datensatzvariable

Eine Datensatzvariable enthält eine Reihe von Daten, die aus einer Datenbank, einem Arbeitsblatt oder einer Tabelle in Namens-Feld-Paaren extrahiert wurden. Die Felder können Werte des Datentyps Boolescher Wert, Datum/Zeit, Nummer oder Zeichenfolge speichern.

Arbeiten mit einer Datensatzvariablen

Datensatzvariablen werden in der Regel in Bezug auf die Schleifen-Aktion verwendet, um eine einzelne Zeile der abgerufenen Daten zu speichern. Sie können auf einen einzelnen Wert zugreifen, indem Sie die Indexnummer oder den Namen angeben. Die Indexnummer ist die Position des Namens-Feld-Paares. Der Name wird entweder bei der Initialisierung der Variablen konfiguriert oder er kann aus den Spaltenüberschriften der Quelltabelle entnommen werden.

Im Folgenden finden Sie eine Beispieltabelle:

Kundenname Stadt
Dana Pittsburgh
Sam Los Angeles
Alex Boston
In diesem Beispiel durchläuft eine Bot-Schleife die vorangehende Tabelle und ordnet jede Zeile rCurrentRow zu. Um den Wert aus der ersten Spalte jeder Zeile abzurufen, verwenden Sie entweder die Indexnummer $rCurrentRow[0]$ oder den Namen $rCurrentRow{CustomerName}$.
Anmerkung: Um einen Datums- und Zeitwert aus einer Datensatzvariablen abzurufen und ihn als Zeichenfolge zu verwenden, verketten Sie die Datensatzvariable mit einem Zeichenfolge-Wert im Feld Aktion.

Schema

Ein Schema ist wie eine Vorlage für die Datensatzfelder. Es legt die Reihenfolge der Felder und die Art der Daten fest, die in jedes Feld eingegeben werden können.

Wenn Sie beim Erstellen einer neuen Datensatzvariablen die Option Schema festlegen wählen, gelten zur Laufzeit die folgenden Bedingungen, wenn der Bot eine Datenzeile abruft und in einer Datensatzvariablen speichert:
  • Die abgerufenen Werte müssen mit den konfigurierten Felddatentypen übereinstimmen.

    Zum Beispiel kann der Datensatz [{"name":"Sally"},{"id":002},{"dob":03/05/1989}] einer Datensatzvariablen mit dem Schema [{"name":String},{"id":Number},{"dob":Date}] zugewiesen werden.

  • Die Attribute des Datensatzes müssen die gleiche Reihenfolge und Großschreibung aufweisen.

    Zum Beispiel kann der Datensatz [{"name":"Henry"},{"id":003},{"dob":06/13/2001}] nicht einer Datensatzvariablen mit dem Schema [{"id":Number},{"name":String},{"dob":Date}] oder {"Name":String},[{"ID":Number},{"DOB":Date}] zugewiesen werden.

  • Die Datensatzvariable kann eine Obermenge der konfigurierten Felder aufnehmen, wenn die Felder in der gleichen Reihenfolge angeordnet sind.

    Zum Beispiel kann der Datensatz [{"name":"Alex"},{"id":004},{"dob":12/10/1995},{"pet":"yes"}] einer Datensatzvariablen mit dem Schema [{"name":String},{"id":Number},{"dob":Date}] zugewiesen werden.

  • Die Datensatzvariable akzeptiert keine Teilmenge von Daten.

    Zum Beispiel kann der Datensatz [{"id":005},{"dob":05/21/1975}] nicht einer Datensatzvariablen mit dem Schema [{"name":String},{"id":Number},{"dob":Date}] zugewiesen werden.

Wenn der Bot auf eine Datenzeile trifft, die nicht dem Schema der Datensatzvariablen entspricht, schlägt der Bot fehl. Dadurch wird verhindert, dass das Bot falsche oder ungültige Daten an die nächste Aktion weitergibt.