Das Plugin xt_pro_import () ermöglicht Ihnen verschiedenste Daten aus .csv-Dateien in Ihren Shop zu importieren.
...
Bitte beachten Sie das wir nur Kunden mit aktiven Support-Verträgen bei diesem Plugin unterstützen können!
...
Installation und Benutzung des xt_pro_import:
Das Plugin kann ganz normal wie jedes andere Plugin ab der Version 4.2.0 installiert werden. (Anleitung Plugin installation )
...
Nach der Installation finden Sie das Plugin unter Inhalte => Pro Import/Export
Erstellen Sie einen neuen Import oder Export indem Sie auf "New"/"Neu" klicken. Für diesen Test werden wir zuerst einen Export erstellen:
Danach öffnet sich folgender Dialog:
dem das Plugin erfolgreich installiert wurde lässt sich schnell und bequem mittels einer einfachen csv-Datei mit nur 2 Spalten bspw. Produkt-ID (products_id) und Produktbeschreibung (products_description), die Beschreibung aller Produkte ändern. Um die Benutzeroberfläche mit all seinen Erneuerungen etwas besser kennenzulernen und zu verstehen, ist es ratsam vorweg einen Export zu erstellen.
Um einen Export zu definieren muss nach dem Aufruf des Plugins im Backend der Button "NEU" geklickt werden.
| Option | Beschreibung |
|---|---|
| Import/Export | Der Typ der Operation |
| Typ | Art der Operation. Aktuell werden Produkte (Products) und Kundengruppen / Staffelpreise (Price groups) unterstützt. |
| Primärschlüssel | Der Primärschlüssel, entspricht der CSV-Zeile die der Datenbank Zeile zugewiesen ist. (Die Option spielt keine Rolle für den Export.) Bei Importen werden die Produkte anhand dieses Schlüssels zueinander zugeordnet und ggf. aktualisiert. |
| Sekundärschlüsse | Der Sekundärschlüsse, entspricht der CSV-Zeile die der Datenbank Zeile zugewiesen ist. |
| Beschreibung | Ihre Beschreibung für diesen Operation. Bei sehr vielen Exporten/Importen können Sie sich hier eine Notiz hinterlegen. |
| Dateiname | Dateiname unter welcher der Export im Export Verzeichnis gespeichert wird bzw. beim Import eingelesen wird. |
| Trennzeichen | Das Trennzeichen welcher in der CSV benutzt wird. |
| Trennzeichen (Kategoriepfaad) | Das Trennzeichen welcher benutzt wird um die Kategorien zu trennen |
| Texttrenner | Das Texttrenner welcher in der CSV benutzt wird. |
| Datensätze pro Durchgang | Wie viele Artikel man in einem Prozess erstellen sollte. |
| Sprachabhängig | Sie sollten ein Hacken setzen, wenn mehrere Sprachen in der CSV Datei existieren, z. B. Artikel Titel oder Artikel Beschreibung. Wen ein Artikel in einer Sprache in der CVS existiert und der Hacken ist nicht gesetzt, wird der Artikel in der default Sprache des Shops exportiert. |
| ID | einzigartig automatisch generierte Zeichenkette (string). |
Export Felder wählen:
Nachdem Sie den neuen Export erstellt haben, müssen Sie die Export Felder wählen. Wählen Sie "Setup Fields Mapping". Es wird danach ein neuen Tab mit allem möglichen Export Feldern geöffnet.
Wenn alle Punkte definiert sind, kann gespeichert werden. Im Anschluss wird nach dem der angezeigte Tab neu geladen wurde, der definierte Export angezeigt. Nun muss das Mapping konfiguriert werden, dazu muss das Action-Icon "Setup Fields Mapping" geklick werden.
In der Tabellenansicht sieht man nun alle Informationen die sich zu einem Produkt exportieren lassen. Für das Beispiel, aktualisieren der Produktbeschreibung genügt es eigentlich, dass Mapping für Produkt-ID (products_id) und Produktbeschreibung (products_description) zu definieren aber zusätzlich nehmen wir hier noch den Produktpreis (products_price) und Externe ID (external_id).
| Info | ||
|---|---|---|
| ||
Wenn man ein Export erstellt, braucht man mindestens ein Primärschlüssel als Angabe. |
| Option | Bedeutung |
|---|---|
| Store Field | Feld der Artikel Tabellen |
| CSV Field | Dieses wird der Name der Spalte in der CSV Datei. Per default sind alle CSV Felder sind auf keine Auswahl gesetzt, Felder mit "keine Auswahl" werden nicht exportiert. Wenn Sie eine Angabe machen wird die Angabe unter diesem Namen der Spalte exportiert. |
| PHP-Code | |
| Reihenfolg | Position jeder Spalte in der CSV-Datei. |
...
| . |
In diesem Beispiel haben wir drei Export Felder angegeben: ProductID, ProductPrice and ProductName.
Speichern Sie Ihre Angaben nachdem Sie alles wie gewünscht konfiguriert haben:
Nun können Sie den Export starten:
Im Verzeichnis /export/ werden Sie die neue Datei mit dem Namen den Sie zuvor vergeben haben finden .
Wie Sie sehen können ist die ProductName Kolumne mit einem Suffix exportiert worden für jede Sprache des Shops, da wir den Hacken bei ” Sprachabhängig” gesetzt haben.
Jetzt können wir ein paar Werte ändern und ein Import erstellen, damit wir den bestehenden Artikel aktualisieren können. Ändern Sie den Preis für ein paar Artikel und speichern Sie die Datei.
Gehen Sie zurück ins Hauptmenü und erstellen Sie eine neue Operation, nur jetzt einen Import:
Es ist wichtig, dass Sie den richtigen Primärschlüssel, den richtigen Dateinamen (Der Shop sucht nach der Datei mit diesen Namen im Verzeichnis /export/), Trennzeichen, Trennzeichen (Kategoriepfad) und Sprachabhängig Hacken setzen.
Speichern Sie den Import.
Wenn Sie jetzt auf Setup Fileds Mapping für diesen Import navigieren, werden Sie sehen dass das Plugin automatisch eine Liste erstellt hat mit den verfügbaren Spalten der CSV-Datei, somit müssen Sie nur noch die Felder entsprechend zuweisen.
Per Default sind alle gefundenen Spalten einer "No Selection" (Keine Auswahl) zugewiesen in der Datenbank (diese werden nicht importiert).
Wenn Sie z. B. Nur die Artikel Preise aktualisieren wollen und nicht die Artikel Namen, müssten Sie die ProductID und Product Price Spalte so setzen:
Speichern Sie das Mapping und starten Sie den Import. Nach der Ausführung werden Sie sehen, dass die Artikel mit den neuen Preisen aktualisiert worden sind, wie Sie es in der CSV Datei angegeben haben.
Import von Sprach- und Mandantenabhängigen Daten:
Sollten Sie Daten in den den Shop importieren wollen, die Sprach- und/oder Mandantenabhängigen sind, zum Beispiel die Produktbeschreibun, müssen Sie an das Feld "products_description" noch die Mandanten-ID bzw. Sprachcode anhängen:
D.h. Sie müssten das Feld products_description auf das Feld XY_1_de mappen, damit der Inhalt des Feld XY in Mandant 1 in die Sprache Deutsch importiert wird.Zurück zur Übersicht geht es mit Abspeichern der gewünscht Konfiguration. Der Export kann nun gestartet werden. Die Datei prd-export.csv liegt nun im Shop-Verzeichnis /export und sieht in diesem Fall wie folgt aus.
Um die Beschreibung im Shop zu ändern müssen in der csv-Datei die entsprechenden Felder geändert werden. Dies kann dann in etwas so aussehen.
Ähnlich wie beim definieren des Exports, muss nun eine Definition für das Update erstellt werden.
Anschließend muss wieder das Mapping der Felder für das Update durchgeführt werden.
Nach erfolgreichen speichern kann die Aktualisierung der Artikel gestartet werden.
Die Erfolgsmeldung spricht für sich wenn diese so angezeigt wird.
Wir wünschen Ihnen viel Erfolg beim testen des Plugins udn unn freuen uns über jedes Feedback an helpdesk@xt-commerce.com
...