ReadExcelFile (FPScript)
Liest einen oder mehrere Datensätze aus einer Excel-Datei.
Syntax
ReadExcelFile(Path, [ Schema ], [ Sheet = 0 ], [ ChannelIdentifier ], [ CalendarTime = FALSE ], [ Signal = FALSE ], [ DataRange = READEXCEL_DR_COMPLETE ], [ RangeFrom ], [ RangeTo ] [ , Duration ])
Die Syntax der ReadExcelFile-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Path |
Zeichenkette mit dem Pfad der einzulesenden Datei. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette (Dateiname). Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||
Schema |
Aliasname eines in der Projektdatenbank gespeicherten Schemas, das alle zum Import notwendigen Einstellungen beinhaltet, oder der Pfad eines auf der Festplatte gespeicherten XML-Schemas oder alle notwendigen Einstellungen als XML-Zeichenkette. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
Sheet |
Name oder Index (beginnend mit 0) des zu verwendenden Excel-Arbeitsblatts. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl, 32-Bit Ganzzahl, 64-Bit Ganzzahl und Zeichenkette. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 0 gesetzt. |
||||||||||||
ChannelIdentifier |
Nummer des einzulesenden Kanals (beginnend mit 1) oder der einzulesenden Kanäle. Wird keine Kanalnummer angegeben, so werden alle Kanäle zurückgegeben oder, falls vorhanden, die Selektion aus dem gewählten Schema verwendet. Wird ein Einzelwert als ChannelIdentifier angegeben, so wird der Kanal als Datenreihe oder Signal zurückgegeben. Ansonsten werden die Kanäle als Liste zurückgegeben. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle ganzzahligen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
CalendarTime |
Wahrheitswert, der angibt, dass Zeitinformationen als Kalenderzeiten gelesen werden sollen. Andernfalls liefert die X-Komponente die Zeit in Sekunden seit Beginn der Messung. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
||||||||||||
Signal |
Wahrheitswert, der angibt, dass Elemente als Signale importiert werden sollen. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
||||||||||||
DataRange |
Wert, der angibt, welche Art von Datenausschnitt gebildet werden soll. Das Argument DataRange kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert READEXCEL_DR_COMPLETE gesetzt. |
||||||||||||
RangeFrom |
Absoluter oder relativer Zeitpunkt des ersten zu lesenden Werts, wenn die Daten nicht von Anfang an gelesen werden sollen. Wenn der X-Datensatz Kalenderzeitwerte enthält, wird hier eine Kalenderzeit erwartet, ansonsten eine Fließkommazahl. Wird das Argument nicht angegeben oder ist den Datensätzen kein X-Datensatz zugeordnet, so werden die Daten vom ersten Wert an gelesen. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
RangeTo |
Absoluter oder relativer Zeitpunkt des letzten zu lesenden Werts, wenn die Daten nicht bis zum Ende gelesen werden soll. Wenn der X-Datensatz Kalenderzeitwerte enthält, wird hier eine Kalenderzeit erwartet, ansonsten eine Fließkommazahl. Wird das Argument nicht angegeben oder ist den Datensätzen kein X-Datensatz zugeordnet, so werden die Daten bis zum letzten Wert gelesen. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
Duration |
Zeitdauer des Datenausschnitts. Dieser Wert muss angegeben werden, wenn das Element DataRange den Wert READEXCEL_DR_FROMDURATION, READEXCEL_DR_DURATIONLAST oder READEXCEL_DR_FIRSTDURATION hat. Dieses Argument wird nur unterstützt, wenn ein X-Datensatz spezifiziert wurde. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Anmerkungen
Wenn eine Datei mit dem Importassistenten importiert wird, so besteht die Möglichkeit, das Schema mit den Einstellungen in der Vorlagendatenbank abzuspeichern. In diesem Fall können Sie über den Aliasnamen auf die Einstellungen zurückgreifen. Werden die Einstellungen nicht als Schema gespeichert, so können Sie die Einstellungen auch direkt in Form einer XML-Zeichenkette der Funktion übergeben. Im Organisieren-Dialogfeld können Sie ein gespeichertes Schema in einer XML-Datei abspeichern. In der ReadExcelFile können Sie auch direkt auf eine solche XML-Datei zugreifen. Wenn ein Eintrag in der Datei nicht als Zahl interpretiert werden kann, dann wird an der entsprechenden Stelle ein ungültiger Fließkommawert in das Ergebnis eingetragen.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
ReadExcelFile("c:\\examples\\file.xlsx", 1, "", 2)
Liest den zweiten Kanal aus der Datei c:\examples\file.xlsx ein. Für den Import werden Vorgabeeinstellungen verwendet.