Was ist ein "Produkt / Regel CSV Import" und wofür wird es verwendet?

Links in der Sidebar ist der Punkt „Import“. Bei einem Klick auf diesem öffnet sich ein neues Fenster.

Hier kann nun auf den Button „Datei-Upload via Drag'n'Drop oder Klick“ geklickt werden oder die Datei auf diese Box geschoben werden.

In der CSV-Datei dürfen keine Umlaute bzw. Sonderzeichen [á à é è í ì ó ò ú ù ä ö ü ß] in Feldern vorhanden sein, die eine Verknüpfung zu anderen Datensätzen definieren (Beispiel: Name der Preismatrix). Artikelnamen und Beschreibungen hingegen dürfen auch Sonderzeichen enthalten.

Für einen Zeilenumbruch in einer Beschreibung muss ein "<br>" statt eines Zeilenumbruchs eingetragen werden.

Bevor die CSV-Datei hochgeladen werden kann, sollte sichergestellt sein, dass sie richtig aufgebaut ist und die Domain sowie Sprache im Browser über dem Upload-Feld hinterlegt wurden.

Eine Beispieldatei für ein Produkt finden Sie in der nebenstehenden Box unter dem Namen "csv-import-shopkunden-handler.csv.zip".

Eine Beispieldatei für Regeln finden Sie in der nebenstehenden Box unter dem Namen "beispiel-regel-import.csv.zip".

Um die Dateien nutzen zu können, müssen Sie diese herunterladen und im Anschluss die ZIP-Dateien mit einem Doppelklick entpacken.

Die Spaltennamen bzw Typen des Produktes unterscheiden sich von den Regeln.

Die verwendbaren Typen sind Hier zu finden.

In der Spalte „data-type“ wird festgelegt welches Element importiert werden soll. Wird dort "default" eingetragen importiert es ein normales Produkt Element.

Ist der Upload erfolgreich wird dies unter dem Fenster angezeigt. width-height, "material-picker", "custom-text", "price-per-unit", "float-input", "select-box" & "material" bezeichnen Elemente welche spezielle Funktionen enthalten, welche durch Plugins umgesetzt wurden. Die Namen entsprechen den Namen der Plugins. "product-rule", "product-rule-condition" und "product-rule-implication" bezieht sich auf den Import von Regeln. (Regelname, Regel Bedingung und Regel Auswirkung)

In der anzulegenden CSV gibt es mindestens die Spalten "data-type", "product-identifier", "section-identifier" und "element-identifier". Diese 4 Spalten sind zwingend für den Import von Produkten und Plugin Elementen erforderlich!

In einer zu importierenden CSV–Datei sieht die erste Zeile daher mindestens folgender Maßen aus wie in nebenstehendem Bild aufgeführt.

Ein ausschließlicher Import von Material und Regeln benötigen diese Spalten nicht (wie der Tabelle zu entnehmen ist). Die Spalten können beliebig um die Werte aus „Spalten Optional“ erweitert werden. Die Reihenfolge der Spalten ist beliebig. Eine größere CSV-Datei kann daher aussehen, wie in nebenstehendem Bild aufgeführt.

Ist für einen „data-type“ eine Spalte nicht notwendig, so kann diese leer gelassen werden. In einem „default“ – Element bleibt beispielsweise die Spalte „min-height“ leer.

In den Spalten „product-identifier“, „section-identifier“ & „element-identifier“ müssen die jeweiligen Identifier hinterlegt werden. Dieser ist in den entsprechenden Reitern, im bereits existierenden Produkt zu finden. Existiert das Produkt bzw. die Sektion oder das Element nicht, wird dieses mit dem Identifier aus der csv erstellt.

Die Werte aus „Spalten Pflicht“ und „Spalten Optional“ bezeichnen die jeweiligen Felder im Produkt Backend. Die Namen sind identisch zu den Feldbezeichnungen. Ihre Funktion ist direkt am Namen abzulesen.

Optionale Spalten welche mit einem „_“ enden, können mit mehreren Werten befüllt werden. Beispielsweise Preise & Rabatte. Die Spalte „product-price_0“ enthält den Wert der Kundengruppe Shopkunde, die Spalte „product-price_1“ wird genutzt um die Kundengruppe Haendler zu befüllen. Die optionalen Spalten sind somit unbegrenzt erweiterbar.

Zur Erläuterung ein Beispiel aus der Beispieltabelle:
Die Spalte: „product-price_0“ importiert den Produktpreis: 1990|Shopkunden|EUR
1990 -> Preis des Produktes in Cent
Shopkunden -> Name der Kundengruppe
EUR -> Währung
| dient dazu, alle Werte voneinander zu trennen und muss in der CSV vorhanden sein.

Bitte beachten:
- Nur wenn die Kundengruppe existiert, wird der Preis auch entsprechend importiert, andernfalls wird der Preis nicht übernommen.
- Es können keine Kundengruppe mit Umlauten importiert werden. Sollte Die Kundengruppe einen Umlaut enthalten, so muss diese umbenannt werden.

Um den Regel Import zu erklären, ist hier ein Beispiel eingeblendet, an dem die Zeilen erklärt werden. Alle Spalten [data-type, product-identifier name, conditions-operator, implications-operator, section-identifier, element-identifier, operator] sind Pflicht und müssen angelegt werden.

In der Spalte „data-type“ wird festgelegt, welcher Teil der Regel bearbeitet wird. Durch "product-rule" werden die Basiseinstellungen der Regel festgelegt. Der "product-identifier" ist der einmalige Identifier des Produkts, den die Regel trifft. In der Spalte "Name" wird der Regelname festgelegt. In "conditions-operator" und "implications-operator" wird festgelegt, wie die Regel arbeitet. Wenn die Bedingung (engl. condition) "AND" ist, müssen alle Bedingungen erfüllt sein, dass die Auswirkung ausgelöst wird. Sollte "OR" hinterlegt sein, muss nur eine Bedingung zutreffen. Bei der Auswirkung (engl. implication) verhält sich der Operator genauso wie bei der Bedingung. Der "section-identifier" und "element-identifier" zielen auf das zu erfassende Element ab und der "operator" kann ein "active" für einen Aktiven Zustand oder ein "inactive" für einen Inaktiven zustand enthalten. In der Zeile mit dem data-type "product-rule" bleiben die Spalten des Sektions- und Elementidentifiers jedoch leer, da diese nicht zu den Grundeinstellungen einer Regel gehören. Der operator kann schon als active oder inactive als Einstellung der Regel gesetzt werden, ob diese Aktiv ist oder noch nicht.

Der data-type "product-rule-condition" ist nun eine Bedingnung und "product-rule-implication" eine Auswirkung, die zur Regel hinzugefüht wird. Der product-identifier und name muss jedoch mit der Regel übereinstimmen. Die Felder conditions-operator und implications-operator mussen leer bleiben. Im section-identifier wird der Identifier der Sektion angegeben, die sich im Produkt befindet und die Bedingung bzw. Auswirkung einfluss nimmt. Wenn die ganze Sektion betroffen ist und nicht nur ein Element, kann der element-identifier weggelassen werden, ansonsten muss der element-identifier des betroffenen Elements angegeben werden. Wie im Bild oben zu sehen wurde als Bedingung gesetzt, dass wenn das Element "manuell" in der Sektion "bedienart" ausgwählt also Aktiv ist, die Farben blau und rot nicht aktiv sind.

Akzeptiert beim Regelimport werden folgende Vergleichsoperatoren:

eq = gleich
lt = kleiner
gt = größer
le = kleiner gleich
ge = größer gleich
ne = ungleich

Andere Vergleichsoperatoren sind aktuell nicht möglich und würden beim Import eine Fehlermeldung verursachen.

Der Name der zu importierenden CSV ist unerheblich. Es können auch mehrere CSV-Dateien hochgeladen werden. Durch eine Auswahl der entsprechenden .csv-Datei wird der Import automatisch gestartet. Sollte dieser erfolgreich sein, wird es unter dem Fenster angezeigt.

Eine Fehlermeldung könnte "Datatype ... not found." sein. Dies tritt auf, wenn in der Spalte "data-type" kein eingetragener Wert ist.

Bei der Fehlermeldung "identifier cant be empty string" wurde eine Eintragung in einen der Identifier nicht gesetzt. Diese sind jedoch Pflichtfelder. Das betrifft die Spalten „product-identifier“, „section-identifier“ & „element-identifier“.