Datenimport: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
Zeile 43: Zeile 43:
 
== Aufbau des Anwendungsfensters ==
 
== Aufbau des Anwendungsfensters ==
  
Bei Programmstart öffnet sich das Fenster "ASCII-Datenimport (Mandant: XXX)".
+
[[image:datenimport modell.png|verweis=]]
  
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).
 
Alle Reiter enthalten jeweils eine Steuerdatentabelle (oben), eine Ziel-Quelldaten-Zuordnungstabelle (Mitte) und ein Mitteilungsfenster des Datenimports (unten).

Version vom 1. April 2019, 11:36 Uhr

Templ loc-blk.png
erreichbar über:
Im-/Export

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

Datenimport modell.png


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.


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.

Importquelle

Datenimport quelle.png
Mit diesem Button ordnen Sie dem markierten Importformat eine andere Datenquelle zu.
Wurde eine Importdatei gewählt, wird diese in der Datenbank gespeichert, bis diese aktualisiert oder eine andere Datei gewählt wird.
Zur Auswahl stehen die folgenden Möglichkeiten:
  • Textdatei
Bei dieser Option können Sie eine Textdatei auswählen.
Sofern Sie eine Datei von Ihrem lokalen PC für den Import nutzen möchten, beachten Sie bitte die hier dargestellten Hinweise zum Erreichen der lokalen Laufwerke.
  • FTP
Diese Option öffnet ein Konfigurationsmenü für die Einrichtung eines FTP-Zugangs, um über diesen Importdatei abrufen zu können.
  • Datenbank
Wird diese Option gewählt, kann über die Eingabe einer Import-ID die dort hinterlegte Importdatei als Quelle verwendet werden.

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.

Einzelimport

Datenimport einzelimport.png
Mit dem Einzelimport ist es möglich, nur die gewünschten Datensätze zu importieren.
Wird diese Importart gewählt, so erscheint ein Fenster mit den in der Importdatei vorhandenen Datensätzen.
Hier können mithilfe der Checkboxen am linken Rand der Tabelle die zu importierenden Datensätze markiert werden.
Durch den Klick auf Übernehmen werden diese in die Datenbank übertragen.
Zusätzlich befindet sich am unteren Rand des Fensters ein Suchfeld, um Datensätze schneller finden zu können.
Hierbei handelt es sich um eine Teilstringsuche, sprich: Es können Bestandteile der Felder gesucht werden. Ist die Kurzbezeichnung bspw. "Fahrrad", so kann nach "Fahr" gesucht werden, um entsprechende Artikel zu finden.


Importtypen

Artikeldaten

Informationen

Zielfelder

Artikel CrossSelling

Informationen

Zielfelder

Artikelvarianten

Informationen

Zielfelder

Artikeleigenschaften

Informationen

Zielfelder

Artikel Herstellernr.

Informationen

Zielfelder

Artikel Shopthemen

Informationen

Zielfelder

Artikel Sonderpreise

Informationen

Zielfelder

Adressendaten

Informationen

Zielfelder

Belegimport

Informationen

Zielfelder

Lager-/Bestandsdaten

Informationen

Zielfelder

👷  Bilder

Informationen

Zielfelder

👷  Warenschlüssel

Informationen

Zielfelder

Navigation
Datenimport
zum Anfang der Seite