Installation und Daten-Import

Installation

Die Installation erfolgt wie bei jedem Shopware 6 Plugin über den Plugin-Manager oder per CLI (bin/console plugin:install --activate OncoCompatibilityFilter).

Nach der Aktivierung findet ihr die Einstellungen in der Administration unter Kataloge » Kompatibilitätsfilter.

Wenn es Probleme bei der Installation geben sollte, zögert bitte nicht, uns zu kontaktieren.

Daten-Import

Für den produktiven Einsatz müssen die Objekte (z. B. Fahrzeuge, Geräte, Drucker) und ihre Verknüpfung zu Artikeln ins Plugin importiert werden. Da diese Datenmengen in typischen Anwendungsfällen sehr groß sind, erfolgt der Import per CSV-Datei über die Konsole.

Voraussetzungen

Eine kurze Einführung in die Shopware-CLI gibt es in der Shopware-Doku.

Falls dir das nichts sagt: Keine Sorge, wir zeigen dir gerne, wie das funktioniert, und du wirst schnell von der einfachen Handhabung überzeugt sein.

Individueller Import

Falls ihr Daten importieren möchtet, die nicht zum unten beschriebenen Schema passen, lasst es uns gerne wissen. Wir haben schon viele individuelle Import-Varianten umgesetzt und finden sicher auch für eure Daten eine Lösung.

Import-Formate

"All in one": Objekte und Artikel in einer Datei

Der Klassiker: eine Datei mit allen Informationen zu Objekt und zugehörigen Artikeln.

Das Objekt wird mit einem Level pro Spalte beschrieben (level1 bis level[x]). In der Spalte article stehen die Artikelnummern der passenden Artikel. Mehrere Artikel pro Zeile werden mit Pipe (|) getrennt.

Beispiel:

level1;level2;level3;article
Manufacturer 1;Type A;Model Z;SW10001|SW10002
Manufacturer 1;Type A;Model Y;SW10001
Manufacturer 1;Type B;Model X;SW10001
Manufacturer 1;Type B;Model W;SW10001
Manufacturer 2;Type C;Model H;SW10001
Manufacturer 2;Type C;Model I;SW10001
Manufacturer 2;Type B;Model F;SW10001
Manufacturer 2;Type B;Model G;SW10001

Reiner Objekt-Import

Zur reinen Pflege der Objekte ohne Artikel-Zuordnung kann das gleiche Format verwendet werden. Die Spalte article lasst ihr einfach weg.

Beispiel:

level1;level2;level3
Manufacturer 1;Type A;Model Z
Manufacturer 1;Type A;Model Y
Manufacturer 1;Type B;Model X
Manufacturer 1;Type B;Model W
Manufacturer 2;Type C;Model H
Manufacturer 2;Type C;Model I
Manufacturer 2;Type B;Model F
Manufacturer 2;Type B;Model G

Zusätzlich können folgende Spalten genutzt werden:

Spalte	Bedeutung
external_id	Eigene ID, die zur Identifikation des Objekts genutzt werden kann.
kba	KBA-/Schlüsselnummer des Objekts (z. B. HSN/TSN bei Fahrzeugen).
description	Beschreibungstext des Objekts (wird auf der Landingpage angezeigt).
image	Link zu einem Bild des Objekts.

Import ausführen

Legt die vorbereitete CSV-Datei auf eurem Server ab und startet den Import mit:

php bin/console onco-comp:import [Pfad zur Import-Datei]

Der Import läuft und informiert euch laufend über den Fortschritt.

Weitere Konsolenbefehle

Eine vollständige Übersicht aller Konsolenbefehle findet ihr auf der Seite Befehlszeile. Die häufigsten im Schnellüberblick:

Daten zurücksetzen

Mit diesem Befehl könnt ihr eure Daten zurücksetzen. Achtung: Dabei werden alle Daten zu Objekten und Verknüpfungen gelöscht:

php bin/console onco-comp:reset all

Wenn nur die Verknüpfungen (nicht aber die Objekte) entfernt werden sollen:

php bin/console onco-comp:reset link

Export

Um den aktuellen Datenbestand zu exportieren:

php bin/console onco-comp:export [Pfad zur Export-Datei]

Dabei wird eine Datei im "All in one"-CSV-Format erstellt.

SEO URLs neu generieren

Generiert die SEO-URLs für alle Objekt-Landingpages in allen Sales Channels und Sprachen neu:

php bin/console onco-comp:generate-seo-urls

Cronjob

Der Cron-Befehl sollte regelmäßig eingeplant werden. Er aktualisiert u.a. die Informationen für Universalartikel und markiert Objekte, die in keinem Sales Channel mehr gültige Artikel haben:

php bin/console onco-comp:cron