Datenimport

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche

Das Datenimport-Tool dient der Übernahme von fremden Artikel- oder Adressdaten in den e-vendo-Datenbestand.



Voraussetzungen

  • Die Fremddaten müssen als ASCII-Datei zur Verfügung stehen.
  • Jeder Datensatz belegt eine Zeile.
  • Nach dem letzten Datensatz muss genau ein Zeilenumbruch erfolgen.
  • Die Datenfelder müssen durch ein festzulegendes Zeichen (Semikolon, Schrägstrich, Prozentzeichen, Anführungszeichen oder Ausrufungszeichen) getrennt oder durch feste Länge identifizierbar sein. Beim Artikelimport benötigt das letzte Feld eines Datensatzes auch ein Trennzeichen.
  • Die erste Zeile der ASCII-Datei kann eine Liste der Feldnamen enthalten.
  • Bei Importart "feste Länge" muss die Feldnamenliste folgende Struktur aufweisen:
Feldname1(Anzahl Zeichen);Feldname2(Anzahl Zeichen);....;FeldnameN(Anzahl Zeichen)
  • Das Trennzeichen der Feldnamenliste ist wählbar wie bei Importart "Trennzeichen".
  • Da im ImportASCII-Tool jedem Zielfeld (mit Ausnahme der Schlüsselfelder) ein Defaultwert zugeordnet werden kann, muss nicht für jedes Zielfeld ein (Quell-)Feld in der ASCII-Datei vorhanden sein.
  • Die Reihenfolge der Felder ist unerheblich, muss aber für alle Datensätze einer ASCII-Datei einheitlich sein und, wenn vorhanden, mit der Feldnamenliste übereinstimmen.
  • Ist ein Feld nicht in jedem Datensatz der ASCII-Datei mit einem Wert belegt, muss für die Importart Trennzeichen auf jeden Fall das Trennzeichen, für feste Länge die entsprechende Anzahl Leerzeichen enthalten sein.

Templ att-blk.png
Bei Anwendung über eine Terminalserversitzung sollte sich die Importdatei unbedingt auf dem Terminalserver befinden.

Templ info-blk.png
Eine Feldnamenliste in der ersten Zeile erleichtert wesentlich die Zuordnungsarbeiten (siehe Beschreibung der Spalten Quellfeldposition, Quellfeldlänge und Quellfeldbezeichnung der Zuordnungstabelle).
Vor einem Import sollte überprüft werden, ob in e-vendo alle notwendigen Hilfsstammdaten eingepflegt wurden. Den Umfang der vorbereitenden Datenpflege entnehmen Sie bitte der Erläuterung der Zielfelder (siehe unten).


Datum- und Zeitformat

Das gültige Format richtet sich nach Ihrer MS-Windows-Einstellung.

  • Ist der Wertebereich eines Zielattributes mit Datum/Zeit bestimmt, muss die Zeit nicht zwingend angegeben werden.
  • Ist der Wertebereich eines Zielattributes mit Datum bestimmt, darf die Zeit nicht angegeben werden.


Arbeiten mit dem Datenimport

Grundsätzlich gehen Sie beim Datenimport wie folgt vor:

  1. Erstellen Sie ein neues Importformat durch Klick auf den Button neuer Import. Wählen Sie die Importdatei aus und geben Sie eine Bezeichnung für das Importformat an. Diese Bezeichnung muss über alle Importtypen eindeutig sein.
  2. Legen Sie die allgemeinen Optionen im Kopfbereich (Art, Trennzeichen, Feldnamen) fest.
  3. Ordnen Sie die benötigten Quellfelder, also die Spalten Ihrer Importdatei, den entsprechenden Zielfeldern zu.
  4. Legen Sie die beim Import zu berücksichtigenden Optionen (rechts und unten im Dialogfenster) fest.
  5. Starten Sie den Impoirt durch Klick auf den Button Daten importieren.


Aufbau des Anwendungsfensters

Bei Programmstart öffnet sich das Fenster "ASCII-Datenimport (Mandant: XXX)".

Das Fenster enthält die unten genannten Reiter für die verschiedenen Importmöglichkeiten sowie eine Buttonleiste rechts.

Alle Reiter enthalten jeweils eine Steuerdatentabelle (oben), eine Ziel-Quelldaten-Zuordnungstabelle (Mitte) und ein Mitteilungsfenster des Datenimports (unten).


Steuerdatentabelle

Bezeichnung
Name des Importformates.
Art
Wählen Sie hier die Struktur der Importdatei: Trennzeichen oder feste Länge.
Trennzeichen
Wählen Sie das in der Importdatei verwendete Trennzeichen aus.
Feldnamen in 1. Zeile
Geben Sie an, ob die erste Zeile der Importdatei eine Feldnamenliste enthält.
1 = Die erste Zeile der Importdatei enthält eine Feldnamenliste.
2 = Die erste Zeile der Importdatei enthält keine Feldnamenliste, sondern den ersten zu importierenden Datensatz.
Textbegrenzungszeichen
Das hier ausgewählte Textzeichen wird als Textbegrenzung für die Quellfeldwerte interpretiert. Befindet sich dieses Zeichen am Anfang/Ende eines Quellfeldwertes, so wird dieses Zeichen nicht importiert.
Währungskurs zum EURO (nur auf den Reitern "Artikel CrossSelling", "Artikelvarianten" und "Artikeleigenschaften")
Alle Preisangaben der Artikelstammdaten werden in e-vendo in EURO abgelegt. Beziehen sich die Preisangaben Ihrer zu importierenden Artikeldaten auf eine andere Währung, müssen Sie in der Spalte Währungskurs zum EURO den aktuellen Umrechnungskurs eintragen, sodass Preis in der Importdatei = Umrechnungskurs * Preis in EURO ergibt.
Das Importtool berechnet dann aus den gelieferten Werten die EURO-Beträge und trägt das Ergebnis beim Artikel ein.
Das gilt jedoch nicht für die lieferantenspezifischen Preise. An dieser Stelle müssen EURO-Preise importiert werden. Für die Anzeige bei den Sonderpreisen des Lieferanten wird beim Aufruf des Reiters der entsprechende Betrag in der jeweiligen Fremdwährung ermittelt.
Dateiname
Pfad und Dateiname der Importdatei.


Ziel-Quelldaten-Zuordnungstabelle

Zielfeld
In dieser Spalte finden Sie alle belegbaren Felder des Importformates.
Quellfeldposition
Aus dieser Spalte ermittelt die Importfunktion die Zuordnung zwischen Zielfeld und Quellfeld.
  • Importart Trennzeichen:
Die Spalte Quellfeldposition muss die Nummer des zugeordneten Quellfeldes (z. B.: 1 für erstes Feld, 4 für viertes Feld) enthalten.
  • Importart feste Länge:
Die Spalte Quellfeldposition muss die Position des ersten Zeichens des zugeordneten Zielfeldes enthalten. Das erste Zeichen einer Datensatzzeile hat die Position 1.
Quellfeldlänge
Der Inhalt dieser Spalte wird nur für einen Import mit der Art feste Länge ausgewertet.
Tragen Sie hier die Anzahl der Zeichen des zugeordneten Quellfeldes ein.
Quellfeldbezeichnung
Die Spalte Quellfeldbezeichnung stellt gemeinsam mit der Feldnamenliste (in der ersten Zeile der ASCII-Datei) eine Zuordnungshilfe dar. Für die Importfunktion selbst besitzt sie keine Bedeutung.
Wurde eine Feldnamenliste in der ersten Zeile der ASCII-Datei angegeben, stehen deren Einträge in der Spalte Quellfeldbezeichnung in Form eines Drop-Down-Menüs zur Verfügung.
Mit der Auswahl eines Quellfeldes für ein Zielfeld werden je nach Importart automatisch die benötigten Zuordnungswerte für die Spalten Quellfeldposition und ggf. Quellfeldlänge berechnet.
Wird keine Feldnamenliste verwendet, müssen die benötigten Zuordnungswerte per Hand in die Spalten Quellfeldposition und ggf. Quellfeldlänge eingetragen werden.
Vorbelegung (bisher Defaultwert)
In der Spalte Vorbelegung kann jedem Zielfeld (mit Ausnahme der Schlüsselfelder wie Artikelnummer und Adressennummer) ein Wert zugewiesen werden, der für alle Datensätze der ASCII-Datei gelten soll. Mit der Zuordnung eines Quellfeldes (Belegung der Spalten Quellfeldposition, Quellfeldlänge) wird die Angabe des Defaultwertes bedeutungslos, auch dann, wenn der Wert des Quellfeldes in einem der zu importierenden Datensätze nicht belegt ist.
Templ info-blk.png
Bei der Angabe von Dezimalzahlen ist die englische Notation zu verwenden; d.h. dass als Dezimaltrennzeichen ein Punkt statt eines Kommas verwendet werden muss.


Mitteilungsfenster

Vorlage:Tab

Kann ein Datensatz nicht importiert werden, so erscheint in diesem Bereich eine Meldung mit einem entsprechenden Hinweis unter Angabe der Zeilennummer der Importdatei. Die erste Datenzeile Ihrer ASCII-Datei hat die Zeilennummer 0.

Vorlage:Tab

Dieser Bereich zeigt den Fortschritt des Datenimports.
Importprotokoll zusätzlich anzeigen
Diese Checkbox ist nur im Reiter "Artikeldaten" vorhanden. Aktivieren Sie diese, um das Mitteilungsfenster "Importprotokoll" ein- bzw. auszublenden.


Buttons

neuer Import

Legen Sie mit diesem Button ein neues Importformat an.
Sie werden nacheinander aufgefordert, eine Importdatei auszuwählen und einen Namen für das neue Importformat anzugeben.
Anschließend können die Konfigurationen eingestellt und die Zuordnung der Zielfelder vorgenommen werden.

🗘 Importformat auf fehlende Importfelder überprüfen

Klicken Sie auf diesen Button, um für das markierte Importformat die Vollständigkeit der Zielfelder zu prüfen.
Damit werden fehlende Zielfelder in der Liste ergänzt. So können ältere Importformate um neu hinzugekommene Zielfelder erweitert werden.

Import löschen

Löscht das markierte Importformat.

Importdatei

Mit diesem Button ordnen Sie dem markierten Importformat eine andere Importdatei zu.

Kopieren

Durch Klick auf diesen Button erstellen Sie eine Kopie des markierten Importformates.
Sie werden aufgefordert einen Namen für das so erstellte neue Importformat anzugeben.

Daten importieren

Klicken Sie auf diesen Button, um den Datenimport mit dem markierten Importformat zu starten.

Schließen

Schließen Sie mit diesem Button das Tool ASCII-Datenimport.


Importtypen

Artikeldaten
Artikel CrossSelling
Artikelvarianten
Artikeleigenschaften
Artikel Herstellernr.
Artikel Shopthemen
Artikel Sonderpreise
Adressendaten
Belegimport