Reimo Fachhändlerbereich Import Datei

Transkript

1 Allgemein Der Reimo Fachhändlerbereich im Internet bietet die Funktionalität, eine Datei mit Bestelldaten zu importieren. Dies erspart Ihnen die Arbeit, eine Bestellung, die Sie bereits in Ihrer EDV erfasst haben, nochmals in das Reimo-Online-Bestellformular einzugeben. Hierfür muss eine Bestelldatei, die auf Ihrem System bereits vorhanden ist, als Datei exportiert und dabei in ein von unserem System lesbares Tabellen-Format umgewandelt werden. Die folgenden Ausführungen sollen Ihnen (bzw. Ihrem Programmierer oder EDV-Experten) ermöglichen, die benötigte Export- und Konvertierungs-Funktion bei sich einzurichten und so eine im Reimo-Fachhandelsbereich importierbare Datei zu erzeugen. Die zu importierende Datei kann wahlweise im XML-Format oder CSV-Format vorliegen. Beide Formate werden im Folgenden noch ausführlich beschreiben. Der Dateiimport einer Datei im XML-Format hat den Vorteil, daß die zu importierende XML-Datei noch vor dem eigentlichen Import auf Richtigkeit geprüft. Datei im CSV-Format Wenn Sie eine Datei im CSV-Format importieren wollen, muss diese die Dateiendung ".csv" oder ".txt" haben (Beispiel: "bestellung.csv"). Sie wird somit als CSV- bzw. Textdatei erkannt, im Gegensatz zu einer XML-Datei jedoch nicht vor dem eigentlichen Import auf syntaktische Richtigkeit geprüft. Eine Prüfung geschieht nur durch die ERP-Software. Die einzelnen Datenfelder müssen alphanumerisch, durch ein Semikolon (";") getrennt sein und dürfen nicht in einfache oder doppelte Hochkommas eingekleidet sein. Ein Datensatz muß folgendermaßen aufgebaut sein: 1. Feld: Reimo Artikelnummer (max. 8 Stellen) 2. Feld: Artikelbezeichnung (max. 80 Stellen) 3. Feld: Menge (max. 4 Stellen, kein Komma oder Punkt) 4. Feld: Kommission (max. 10 Stellen) 5. Feld: Ihre Bestellnummer (max. 8 Stellen) 6. Feld: Wunschliefertermin (tt.mm.jjjj) 7. Feld: gewünschte Versandart (U=UPS/POST, A=Abholung, E=UPS-Express, S=Spedition) 8. Feld: : Name 1 (max. 25 Stellen) 9. Feld: : Name 2 (max. 25 Stellen) 10. Feld: : Strasse (max. 25 Stellen) 11. Feld: : Plz Ort (5 Stellen Plz, 1 Leerzeichen, 19 Stellen Ort) 12. Feld: : Land (max. 3 Stellen) Die Dateifelder 1. "Reimo Artikelnummer" und 3. "Menge" sind Pflichtfelder und müssen gefüllt sein. Alle anderen Dateifelder sind optional und können leer bleiben, müssen jedoch auch mit einem Semikolon beendet werden. Letztendlich müssen im Seite 1 von 13

2 Datensatz also 12 Semikolons enthalten sein. Außerdem darf pro Datei nur eine abweichende Lieferanschrift, ein Wunschliefertermin, eine Versandart und eine Bestellnummer verwendet werden. Der erste Datensatz enthält in gleicher Struktur entsprechende Spaltenüberschriften. Beispiel einer Datei im CSV-Format mit Spaltenüberschrift und zwei Bestellpositionen, die eine abweichende Versandanschrift enthalten. Beispiel CSV-Format: Erster Datensatz (Spaltenüberschrift): Reimo Artikelnummer;Artikelbezeichnung;Menge;Kommission;Ihre Bestellnummer;Wunschliefertermin;gewünschte Versandart;Name 1;Name 2;Strasse;Plz und Ort;Land; Zweiter Datensatz (1. Bestellposition): ;Zubehörkatalog 2013 neutral;1;klinsmann;4711; ;u;;;;;; Dritter Datensatz (2. Bestellposition): 92030;Campingstuhl LA PALMA schwarz;4;klinsmann;4711; ;u;;;;;; Datei im XML-Format Wenn Sie eine Datei im XML-Format importiert wollen, muss diese die Dateiendung ".xml" haben (Beispiel: "bestellung.xml"). Sie wird somit als XML-Datei erkannt und vor dem eigentlichen Import auf syntaktische Richtigkeit geprüft (Validierung). Eine abschließende Prüfung geschieht durch die ERP-Software. Die Validierung selbst wird mit Hilfe der Dokumenttypdefinition "bestellung.xsd" durchgeführt. In ihr sind Regeln über den Aufbau XML-Datei hinterlegt. Die Dokumenttypdefinition "bestellung.xsd" ist im Internet hinterlegt und wird automatisch verwendet, wenn Sie im Kopf der XML-Datei eingetragen ist. Treten bei der Validierung Fehler auf, so werden diesem im Browser angezeigt und die XML-Datei nicht importiert. Da die XML-Datei zur weiteren Verarbeitung in ein anderes Format transformiert wird, muss die XML-Datei im Kopf zusätzliche die entsprechende Transformationsbeschreibung "bestellung.xslt" hinterlegt sein. Wie die XML-Datei aufgebaut sein muß, entnehmen Sie bitte anhängender Dokumenttypdefinition und anhängendem Beispiel. Seite 2 von 13

3 Anhang: Beispiel einer XML-Datei "bestellung.xml" <?xml version="1.0" encoding="iso "?> <?xml-stylesheet type="text/xsl" href="./bestellung.xslt"?> <bestellung xmlns:xsi=" xsi:nonamespaceschemalocation="./bestellung.xsd"> <spaltenueberschrift> <spaltenueberschrift_reimo_artikel_nummer>nummer</spaltenueberschrift_reimo_artikel_nummer> <spaltenueberschrift_artikelbezeichnung>bezeichnung</spaltenueberschrift_artikelbezeichnung> <spaltenueberschrift_menge>menge</spaltenueberschrift_menge> <spaltenueberschrift_kommission>kommission</spaltenueberschrift_kommission> r> <spaltenueberschrift_ihre_bestellnummer>bestellnummer</spaltenueberschrift_ihre_bestellnumme <spaltenueberschrift_wunschliefertermin>termin</spaltenueberschrift_wunschliefertermin> <spaltenueberschrift_gewuenschte_versandart>versandart</spaltenueberschrift_gewuenschte_vers andart> <spaltenueberschrift_abweichende_versandadresse_name_1>name1</spaltenueberschrift_abweichend e_versandadresse_name_1> <spaltenueberschrift_abweichende_versandadresse_name_2>name2</spaltenueberschrift_abweichend e_versandadresse_name_2> <spaltenueberschrift_abweichende_versandadresse_strasse>strasse</spaltenueberschrift_abweich ende_versandadresse_strasse> <spaltenueberschrift_abweichende_versandadresse_plz></spaltenueberschrift_abweichende_versan dadresse_plz> <spaltenueberschrift_abweichende_versandadresse_ort>ort</spaltenueberschrift_abweichende_ver sandadresse_ort> <spaltenueberschrift_abweichende_versandadresse_land>land</spaltenueberschrift_abweichende_v ersandadresse_land> </spaltenueberschrift> <abweichende_versandadresse> <abweichende_versandadresse_name_1></abweichende_versandadresse_name_1> <abweichende_versandadresse_name_2></abweichende_versandadresse_name_2> <abweichende_versandadresse_strasse></abweichende_versandadresse_strasse> <abweichende_versandadresse_plz></abweichende_versandadresse_plz> <abweichende_versandadresse_ort></abweichende_versandadresse_ort> <abweichende_versandadresse_land></abweichende_versandadresse_land> </abweichende_versandadresse> <bestelloptionen> <ihre_bestellnummer></ihre_bestellnummer> <wunschliefertermin></wunschliefertermin> <gewuenschte_versandart></gewuenschte_versandart> <bestelloptionen> <bestellposition> <reimo_artikel_nummer>52706</reimo_artikel_nummer> <artikelbezeichnung>schleifbock</artikelbezeichnung> <menge>1</menge> <kommission></kommission> </bestellposition> <bestellposition> <reimo_artikel_nummer>53002</reimo_artikel_nummer> <artikelbezeichnung>lüftungsgitt.360x120 beig</artikelbezeichnung> <menge>4</menge> <kommission>meier</kommission> </bestellposition> <bestellposition> Seite 3 von 13

4 </bestellung> <reimo_artikel_nummer>82033</reimo_artikel_nummer> <artikelbezeichnung>gummistecker Schuko</artikelbezeichnung> <menge>10</menge> <kommission></kommission> </bestellposition> Seite 4 von 13

5 Anhang: XML-Dokumenttypdefinition "bestellung.xsd" <?xml version="1.0" encoding="iso "?> <xs:schema xmlns:xs=" elementformdefault="qualified" attributeformdefault="unqualified"> <xs:element name="reimo_artikel_nummer"> Reimo-Artikel-Nummer (max. 8 Stellen) <xs:maxlength value="8" /> <xs:element name="artikelbezeichnung"> Artikelbezeichnung <xs:maxlength value="80" /> <xs:element name="menge"> Menge (max. 4 Stellen, kein Komma oder Punkt) <xs:restriction base="xs:integer"> <xs:totaldigits value="4" /> <xs:fractiondigits value="0" /> <xs:element name="kommission"> Kommission (max. 10 Stellen) <xs:maxlength value="10" /> <xs:element name="ihre_bestellnummer"> Ihre Bestellnummer (max. 8 Stellen) <xs:maxlength value="8" /> <xs:element name="wunschliefertermin"> Seite 5 von 13

6 <xs:pattern value="[0-3][0-9][.][0-1][0-9][.][1-2][09][0-9][0-9] [ ]{0}"/> <xs:element name="gewuenschte_versandart"> gewuenschte Versandart (U=UPS/POST, A=Abholung, E=UPS-Express, S=Spedition) <xs:pattern value="[uaes]{1} [ ]{0}" /> <xs:element name="abweichende_versandadresse_name_1"> : Name 1 (max. 25 Stellen) <xs:maxlength value="25" /> <xs:element name="abweichende_versandadresse_name_2"> : Name 2 (max. 25 Stellen) <xs:maxlength value="25" /> <xs:element name="abweichende_versandadresse_strasse"> : Strasse (max. 25 Stellen) <xs:maxlength value="25" /> <xs:element name="abweichende_versandadresse_plz"> : Plz (5 Stellen) <xs:pattern value="[0-9]{5} [ ]{0}" /> <xs:element name="abweichende_versandadresse_ort"> Seite 6 von 13

7 : Ort (max. 19 Stellen) <xs:maxlength value="19" /> <xs:element name="abweichende_versandadresse_land"> : Land (3 Stellen) <xs:maxlength value="3" /> <xs:element name="spaltenueberschrift_reimo_artikel_nummer"> <xs:element name="spaltenueberschrift_artikelbezeichnung"> <xs:element name="spaltenueberschrift_menge"> <xs:element name="spaltenueberschrift_kommission"> <xs:element name="spaltenueberschrift_ihre_bestellnummer"> Seite 7 von 13

8 <xs:element name="spaltenueberschrift_wunschliefertermin"> <xs:element name="spaltenueberschrift_gewuenschte_versandart"> <xs:element name="spaltenueberschrift_abweichende_versandadresse_name_1"> <xs:element name="spaltenueberschrift_abweichende_versandadresse_name_2"> <xs:element name="spaltenueberschrift_abweichende_versandadresse_strasse"> <xs:element name="spaltenueberschrift_abweichende_versandadresse_plz"> Seite 8 von 13

9 <xs:element name="spaltenueberschrift_abweichende_versandadresse_ort"> <xs:element name="spaltenueberschrift_abweichende_versandadresse_land"> <xs:element name="spaltenueberschrift"> Spaltenueberschrift zu den Bestellpositionen <xs:complextype> <xs:sequence> <xs:element ref="spaltenueberschrift_reimo_artikel_nummer" minoccurs="0" /> <xs:element ref="spaltenueberschrift_artikelbezeichnung" minoccurs="0" /> <xs:element ref="spaltenueberschrift_menge" minoccurs="0" /> <xs:element ref="spaltenueberschrift_kommission" minoccurs="0" /> <xs:element ref="spaltenueberschrift_ihre_bestellnummer" minoccurs="0" /> <xs:element ref="spaltenueberschrift_wunschliefertermin" minoccurs="0"/> <xs:element ref="spaltenueberschrift_gewuenschte_versandart" minoccurs="0" /> <xs:element ref="spaltenueberschrift_abweichende_versandadresse_name_1" minoccurs="0" /> <xs:element ref="spaltenueberschrift_abweichende_versandadresse_name_2" minoccurs="0" /> <xs:element ref="spaltenueberschrift_abweichende_versandadresse_strasse" minoccurs="0" /> <xs:element ref="spaltenueberschrift_abweichende_versandadresse_plz" minoccurs="0" /> <xs:element ref="spaltenueberschrift_abweichende_versandadresse_ort" minoccurs="0" /> <xs:element ref="spaltenueberschrift_abweichende_versandadresse_land" minoccurs="0" /> </xs:sequence> </xs:complextype> <xs:element name="bestelloptionen"> Bestelloptionen <xs:complextype> <xs:sequence> <xs:element ref="ihre_bestellnummer" /> <xs:element ref="wunschliefertermin" /> <xs:element ref="gewuenschte_versandart" /> Seite 9 von 13

10 </xs:sequence> </xs:complextype> <xs:element name="bestellposition"> eine Bestellposition <xs:complextype> <xs:sequence> <xs:element ref="reimo_artikel_nummer" /> <xs:element ref="artikelbezeichnung" minoccurs="0" /> <xs:element ref="menge" /> <xs:element ref="kommission" /> </xs:sequence> </xs:complextype> <xs:element name="abweichende_versandadresse"> Abweichende Versandadresse <xs:complextype> <xs:sequence> <xs:element ref="abweichende_versandadresse_name_1" minoccurs="0" /> <xs:element ref="abweichende_versandadresse_name_2" minoccurs="0" /> <xs:element ref="abweichende_versandadresse_strasse" minoccurs="0" /> <xs:element ref="abweichende_versandadresse_plz" minoccurs="0" /> <xs:element ref="abweichende_versandadresse_ort" minoccurs="0" /> <xs:element ref="abweichende_versandadresse_land" minoccurs="0" /> </xs:sequence> </xs:complextype> <xs:element name="bestellung"> Bestellung <xs:complextype> <xs:sequence> <xs:element ref="spaltenueberschrift" maxoccurs="1"/> <xs:element ref="abweichende_versandadresse" minoccurs="0" maxoccurs="1"/> <xs:element ref="bestelloptionen" minoccurs="0" maxoccurs="1"/ > <xs:element ref="bestellposition" maxoccurs="999" /> </xs:sequence> </xs:complextype> </xs:schema> Seite 10 von 13

11 Anhang: XML-Transformation "bestellung.xslt" <?xml version="1.0" encoding="iso "?> <xsl:stylesheet version="1.0" xmlns:xsl=" xmlns:xsi=" <xsl:template match="reimo_artikel_nummer"> <xsl:template match="artikelbezeichnung"> <xsl:template match="menge"> <xsl:template match="kommission"> <xsl:template match="ihre_bestellnummer"> <xsl:template match="wunschliefertermin"> <xsl:template match="gewuenschte_versandart"> <xsl:template match="abweichende_versandadresse_name_1"> <xsl:template match="abweichende_versandadresse_name_2"> <xsl:template match="abweichende_versandadresse_strasse"> <xsl:template match="abweichende_versandadresse_plz"> <xsl:text> </xsl:text> <xsl:template match="abweichende_versandadresse_ort"> <xsl:template match="abweichende_versandadresse_land"> <xsl:template match="spaltenueberschrift_reimo_artikel_nummer"> Seite 11 von 13

12 <xsl:template match="spaltenueberschrift_artikelbezeichnung"> <xsl:template match="spaltenueberschrift_menge"> <xsl:template match="spaltenueberschrift_kommission"> <xsl:template match="spaltenueberschrift_ihre_bestellnummer"> <xsl:template match="spaltenueberschrift_wunschliefertermin"> <xsl:template match="spaltenueberschrift_gewuenschte_versandart"> <xsl:template match="spaltenueberschrift_abweichende_versandadresse_name_1"> <xsl:template match="spaltenueberschrift_abweichende_versandadresse_name_2"> <xsl:template match="spaltenueberschrift_abweichende_versandadresse_strasse"> <xsl:template match="spaltenueberschrift_abweichende_versandadresse_plz"> <xsl:text> </xsl:text> <xsl:template match="spaltenueberschrift_abweichende_versandadresse_ort"> <xsl:template match="spaltenueberschrift_abweichende_versandadresse_land"> <xsl:template match="spaltenueberschrift"> <xsl:apply-templates select="spaltenueberschrift_reimo_artikel_nummer"/> <xsl:apply-templates select="spaltenueberschrift_artikelbezeichnung"/> <xsl:apply-templates select="spaltenueberschrift_menge"/> <xsl:apply-templates select="spaltenueberschrift_kommission"/> <xsl:apply-templates select="spaltenueberschrift_ihre_bestellnummer"/> <xsl:apply-templates select="spaltenueberschrift_wunschliefertermin"/> <xsl:apply-templates select="spaltenueberschrift_gewuenschte_versandart"/> <xsl:apply-templates select="spaltenueberschrift_abweichende_versandadresse_name_1"/> <xsl:apply-templates select="spaltenueberschrift_abweichende_versandadresse_name_2"/> <xsl:apply-templates select="spaltenueberschrift_abweichende_versandadresse_strasse"/> Seite 12 von 13

13 <xsl:apply-templates select="spaltenueberschrift_abweichende_versandadresse_plz"/> <xsl:apply-templates select="spaltenueberschrift_abweichende_versandadresse_ort"/> <xsl:apply-templates select="spaltenueberschrift_abweichende_versandadresse_land"/> <xsl:call-template name="newline"/> <xsl:template match="bestellposition"> <xsl:apply-templates select="reimo_artikel_nummer"/> <xsl:apply-templates select="artikelbezeichnung"/> <xsl:apply-templates select="menge"/> <xsl:apply-templates select="kommission"/> <xsl:value-of select="../bestelloptionen/ihre_bestellnummer"/> <xsl:value-of select="../bestelloptionen/wunschliefertermin"/> <xsl:value-of select="../bestelloptionen/gewuenschte_versandart"/> <xsl:value-of select="../abweichende_versandadresse/abweichende_versandadresse_name_1"/> <xsl:value-of select="../abweichende_versandadresse/abweichende_versandadresse_name_2"/> <xsl:value-of select="../abweichende_versandadresse/abweichende_versandadresse_strasse"/> <xsl:value-of select="../abweichende_versandadresse/abweichende_versandadresse_plz"/> <xsl:text> </xsl:text> <xsl:value-of select="../abweichende_versandadresse/abweichende_versandadresse_ort"/> <xsl:value-of select="../abweichende_versandadresse/abweichende_versandadresse_land"/> <xsl:call-template name="newline"/> <xsl:template name="newline"> <xsl:text> </xsl:text> <xsl:template name="versand"> <xsl:apply-templates select="abweichende_versandadresse_name_1"/> <xsl:apply-templates select="abweichende_versandadresse_name_2"/> <xsl:apply-templates select="abweichende_versandadresse_strasse"/> <xsl:apply-templates select="abweichende_versandadresse_plz"/> <xsl:apply-templates select="abweichende_versandadresse_ort"/> <xsl:apply-templates select="abweichende_versandadresse_land"/> <xsl:template match="/"> <xsl:template match="bestellung"> <xsl:apply-templates select="spaltenueberschrift"/> <xsl:apply-templates select="bestellposition"/> </xsl:stylesheet> Seite 13 von 13