IMPORT EXCEL-Befehl

Erstellt eine Analytics-Tabelle, indem ein Microsoft-Excel-Arbeitsblatt oder ein benannter Bereich definiert und importiert wird.

Syntax

IMPORT EXCEL TO Tabelle Importdateiname FROM Quelldateiname TABLE Eingabearbeitsblatt_oder_benannter_Bereich <KEEPTITLE> {ALLFIELDS|CHARMAX maximale_Feldlänge|[Feldsyntax] <...n> <IGNORE Feldnum> <...n>} <OPEN>

Feldsyntax ::=
FIELD Importname Typ {PIC Format|WID Zeichen DEC Wert} AS Anzeigename

Parameter

Name	Beschreibung
TO Tabelle	Der Name der Analytics-Tabelle, in welche die Daten importiert werden sollen. Hinweis Tabellennamen sind auf 64 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.
Importdateiname	Der Name der zu erstellenden Analytics-Datendatei. Geben Sie Importdateiname als in Anführungszeichen gesetzte Zeichenfolge mit der Dateierweiterung „.FIL“ an. Zum Beispiel: „Rechnungen.FIL“. Standardmäßig wird die Datendatei (.FIL) in den Ordner mit dem Analytics-Projekt gespeichert. Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datendatei in einen anderen bestehenden Ordner zu speichern: "C:\Daten\Rechnungen.FIL" "Daten\Rechnungen.FIL"
FROM Quelldateiname	Der Name der Quelldatendatei. Quelldateiname muss eine in Anführungszeichen gesetzte Zeichenfolge sein. Wenn sich die Quelldatendatei nicht im selben Verzeichnis wie das Analytics-Projekt befindet, muss der Dateispeicherort mit einem absoluten Pfad oder relativen Pfad angegeben werden: "C:\Daten\Quelldateiname" "Daten\Quelldateiname"
TABLE Arbeitsblatt_oder_benannter_Bereich	Das zu verwendende Microsoft-Excel-Arbeitsblatt oder der benannte Bereich der zu importierenden Quelldatendatei: Sie müssen am Ende des Arbeitsblattnamens das Zeichen „$“ eingeben. Arbeitsblatt_oder_benannter_Bereich muss als eine in Anführungszeichen gesetzte Zeichenfolge angegeben werden.
KEEPTITLE Optional	Behandeln Sie die erste Datenzeile als Feldnamen und nicht als Daten. Falls dies ausgelassen wird, werden generische Feldnamen verwendet. Wenn Sie Felder individuell definieren, muss KEEPTITLE vor dem ersten Auftreten von FIELD erscheinen.
ALLFIELDS	Alle Felder in der Quelldatendatei werden importiert. Hinweis Wenn Sie ALLFIELDS festlegen, geben Sie keine individuelle FIELD-Syntax, CHARMAX oder IGNORE an.
CHARMAX maximale_Feldlänge	Gilt nur, wenn Sie Felder nicht individuell definieren. Die maximale Länge in Zeichen eines beliebigen Felds in der Analytics-Tabelle, dessen Ursprung Zeichendaten in der Quelldatendatei sind.
FIELD Importname Typ	Die zu importierenden einzelnen Felder der Quelldatendatei sowie der Name und der Datentyp des Felds. Importname wird der Feldname in der Analytics-Tabelle. Importname muss mit dem Feldnamen in der Quelldatendatei nicht identisch sein, kann jedoch denselben Namen haben. Tipp Sie können zusätzlich AS angeben, um einen Anzeigennamen festzulegen, der sich von Importname unterscheidet. Typ wird der Felddatentyp in der Analytics-Tabelle. Typ muss mit dem Feld Datentyp in der Quelldatendatei nicht identisch sein. Derselbe Datentyp ist jedoch möglich. Weitere Informationen über Typ finden Sie unter Bezeichner für Felddatentypen. Felder ausschließen Damit ein Feld nicht importiert wird, geben Sie es an dieser Stelle nicht an. Sie müssen auch IGNORE für ausgeschlossene Felder angeben.
PIC Format	Hinweis Gilt nur für numerische Felder oder Datumzeit-Felder. Numerische Felder das Anzeigeformat von numerischen Werten in Analytics-Ansichten und -Berichten Datumzeit-Felder das physische Format der Datumzeit-Werte in den Quelldaten (Reihenfolge von Datum- und Zeitzeichen, Trennzeichen usw.) Hinweis Bei Datumzeit-Feldern muss Format genau dem physischen Format der Quelldaten entsprechen. Wenn die Quelldaten beispielsweise „12/31/2014“ enthalten, müssen Sie das Format als "MM/TT/JJJJ" eingeben. Format muss in Anführungszeichen gesetzt werden.
WID Zeichen	Die Feldlänge in Zeichen im Analytics-Tabellenlayout.
DEC Wert	Die Anzahl der Dezimalstellen für numerische Felder.
AS Anzeigename	Der Anzeigename (alternative Spaltentitel) für das Feld in der Ansicht der neuen Analytics-Tabelle. Geben Sie den Anzeigenamen als in Anführungszeichen gesetzte Zeichenfolge an. Verwenden Sie zwischen den Wörtern ein Semikolon (;), wenn Sie die Zeilen in dem Spaltentitel umbrechen möchten. AS wird zur Definition von FIELD benötigt. Damit der Anzeigename mit dem Feldnamen identisch ist, geben Sie für Anzeigename einen leeren Wert mit der folgenden Syntax ein: AS "". Stellen Sie sicher, dass sich zwischen den beiden doppelten Anführungszeichen kein Leerzeichen befindet.
IGNORE Feldnum <...n> Optional	Schließt das Feld aus dem Tabellenlayout aus. Feldnum legt die Position des ausgeschlossenen Felds in der Quelldatendatei fest. Beispiel: IGNORE 5 schließt das fünfte Feld in der Quelldatendatei vom Analytics-Tabellenlayout aus. Hinweis Seien Sie vorsichtig, um Feldnum korrekt an der Position der ausgeschlossenen Felder auszurichten. Wenn Sie Feldnum für ein berücksichtigtes Feld (FIELD-Definition) oder für eine Feldposition festlegen, die nicht existiert, wird der Import nicht ordnungsgemäß durchgeführt. Die Anzahl der FIELD- und IGNORE-Parameter muss insgesamt der Gesamtanzahl der Felder in der Quelldatentabelle entsprechen. Falls die Gesamtanzahl nicht übereinstimmt, wird der Import nicht korrekt funktionieren. Wenn Sie ALLFIELDS festlegen, geben Sie IGNORE nicht an.
OPEN Optional	Öffnet die durch den Befehl erstellte Tabelle, nachdem der Befehl ausgeführt wird. Nur gültig, wenn der Befehl eine Ausgabetabelle erstellt.

Beispiele

Angegebene Felder importieren

Sie führen einen Import aus, durch den eine neue Analytics-Tabelle namens Kreditkarten definiert wird. Er verwendet die erste Zeile der Excel-Daten für die Feldnamen.

Von den zwölf Feldern in der Quelltabelle definiert und beinhaltet die Analytics-Tabelle drei Felder und schließt neun Felder aus:

IMPORT EXCEL TO Kreditkarten "Kreditkarten.fil" FROM "Kreditkarten_Metaphor.xls" TABLE "Firmenkreditkarten$" KEEPTITLE FIELD "CARDNUM" N WID 16 DEC 0 AS "Kartennummer" FIELD "EXPDT" D WID 10 PIC "JJJJ-MM-TT"  AS "Ablaufdatum" FIELD "PASTDUEAMT" N WID 6 DEC 2 AS "Überfällig" IGNORE 2 IGNORE 3 IGNORE 5 IGNORE 6 IGNORE 7 IGNORE 9 IGNORE 10 IGNORE 11 IGNORE 12

Alle Felder importieren

Sie führen einen Import aus, durch den eine neue Analytics-Tabelle namens Mai_Transaktionen definiert wird. Er verwendet die erste Zeile der Excel-Daten für die Feldnamen.

Die Analytics-Tabelle beinhaltet alle Felder der Quelltabelle und verwendet die standardmäßigen Felddefinitionen.

Auf längsten Wert eingestellte Feldlänge

Felder, die in der Quelldatendatei Zeichendaten darstellen, werden im ersten Beispiel auf den längsten Feldwert eingestellt:

IMPORT EXCEL TO Mai_Transaktionen "Mai_Transaktionen.fil" FROM "Trans_Mai.xls" TABLE "Trans1_Mai$" KEEPTITLE ALLFIELDS

Eingeschränkte Feldlänge

Felder, die in der Quelldatendatei Zeichendaten darstellen, werden im zweiten Beispiel auf den längsten Feldwert oder den CHARMAX-Wert von 100 Zeichen gesetzt, falls dieser kürzer ist:

IMPORT EXCEL TO Mai_Transaktionen "Mai_Transaktionen.fil" FROM "Trans_Mai.xls" TABLE "Trans1_Mai$" KEEPTITLE CHARMAX 100

Bemerkungen

Hinweis

Weitere Informationen über die Funktion dieses Befehls finden Sie in Hilfe für Analytics.

Felder einzeln definieren oder alle Felder mit einer Standarddefinition importieren

Wenn Sie eine Excel-Datei in eine Analytics-Tabelle importieren, können Sie die FIELD-Parameter verwenden, um jedes Feld individuell zu definieren. Sie können auch den ALLFIELDS- oder CHARMAX-Parameter nutzen, um alle Felder mit den standardmäßigen Analytics-Felddefinitionen zu importieren.

Maximale Größe des Datenimports

Dateiformat .xlsx oder .xlsm

Die maximale Anzahl an Excel-Spalten und die maximale Anzahl von Zeichen in einem Feld ist bei .xlsx- oder .xlsm-Dateien an keine spezifische Zahl gebunden.

Ein Import dieser Excel-Dateitypen unterliegt jedoch der Grenzvorgabe der Datensatzlänge in Analytics-Datendateien (.fil) von 32 KB. Falls ein Datensatz in der Excel-Quelldatei einen Analytics-Datensatz von über 32 KB erstellt, scheitert der Import.

Dateiformat .xls

Ein Import von .xls-Dateien (Excel 97 - 2003) wird anders verarbeitet. Er unterliegt einer Höchstzahl von

255 Spalten
255 Zeichen pro Feld
32 KB pro Datensatz
65.000 Zeilen

Bezeichner für Felddatentypen

Die folgende Tabelle enthält die Buchstaben, die Sie zur Angabe des Typs für FIELD festlegen müssen. Jeder Buchstabe entspricht einem Analytics-Datentyp.

Wenn Sie beispielsweise ein Feld „Nachname“ definieren, das einen Zeichendatentyp benötigt, würden Sie „C“ festlegen: FIELD "Nachname" C.

Weitere Informationen finden Sie unter Analytics-Datentypen.