Datenimport

Mit dem Datenimport spielen Sie Excel- oder CSV-Dateien in den Katalog ein: neue Datensätze anlegen und bestehende ändern. Navigation: Stammdaten → Datenimport.

Der Import arbeitet in vier Schritten. Bevor etwas gespeichert wird, gibt es immer einen Testlauf.

Wer darf importieren?

Die Seite sehen standardmäßig Super-Admin, Admin und Data Steward. Redakteure (Rolle „matev_pim_editor“) haben sie nicht. Außerdem sehen Sie nur die Importziele, deren Datensätze Sie bearbeiten dürfen.

1. Quelle, Datei und Ziel

Feld	Was Sie wählen
Quelle	„Datei (Excel oder CSV)“. Die Optionen „Averp-API (in Vorbereitung)“ und „Weitere Schnittstelle (in Vorbereitung)“ sind sichtbar, aber noch nicht nutzbar. Eine direkte Anbindung an das ERP gibt es noch nicht.
Was wird importiert?	„Artikel“, „Ersatzteile“, „Produkte“ oder „Projekte“
Datei	Excel (.xlsx, .xls) oder CSV, höchstens 50 MB. Die erste Zeile muss die Spaltenüberschriften enthalten.
Trennzeichen (nur CSV)	„Automatisch erkennen“ (Standard), „Semikolon ( ; )“, „Komma ( , )“, „Tabulator“, „Senkrechter Strich ( | )“. Automatisch erkannt werden Semikolon, Komma und Tabulator, nicht der senkrechte Strich.

Klicken Sie auf „Datei einlesen“. Danach erscheint „… Zeilen eingelesen. Jetzt die Spalten zuordnen.“ Ändern Sie das Trennzeichen später, liest das PIM die Datei neu.

Die Datei wird nur im geschützten Speicher des Servers abgelegt und beim Start des eigentlichen Imports gelöscht.

2. Spalten zuordnen

Links stehen die Spalten Ihrer Datei mit Überschrift und bis zu drei Beispielwerten, rechts wählen Sie das passende Feld im PIM.

• Bekannte Überschriften (etwa „Artikelnummer“, „SKU“, „Bezeichnung“) sind schon zugeordnet. Das PIM merkt sich außerdem die Zuordnungen Ihrer letzten fünf Läufe für dasselbe Ziel.
• „— nicht importieren —“ lässt eine Spalte weg.
• Jedes PIM-Feld kann nur einer Spalte zugeordnet werden.
• Mehrsprachige Felder gibt es je Sprache. Eine Überschrift wie „Name en“ oder „name_en“ wird Englisch zugeordnet.
• Felder mit dem Zeichen „Schlüssel“ taugen zum Abgleich.
• Felder mit „nur mit Averp-Recht“ sind für Sie gesperrt (siehe unten).
• Hat die Excel-Datei mehrere Blätter, wählen Sie oben das Tabellenblatt. „Andere Datei“ beginnt von vorn.

Abgleich über: An diesem Feld erkennt der Import, ob es den Datensatz schon gibt. Zur Wahl stehen nur Schlüsselfelder, die Sie schon zugeordnet haben:

Ziel	Mögliche Schlüssel
Artikel, Ersatzteile	Nummer
Produkte, Projekte	Kennung (Slug) oder Nummer

Verhalten (alle standardmäßig an):

• „Neue Datensätze anlegen“
• „Bestehende Datensätze aktualisieren“
• „Leere Zellen ignorieren“. Schalten Sie das aus, löscht eine leere Zelle den Wert im PIM.

Welche Felder?

Importiert werden nur einfache und mehrsprachige Felder, keine Verknüpfungen (keine Taxonomie-Terme, keine Fahrzeugmarken, keine Produkt-Artikel-Zuordnungen).

• Artikel und Ersatzteile: Nummer, Bezeichnung, Bezeichnung 2, Beschreibung, Typcode, Aktiv, Preis, Preisliste, Verkaufsbasis (EUR), die Warengruppen (Verkauf, Einkauf, Lieferung, Sonstige, Fertigung), Gewicht (kg), Zolltarifnummer, Seriennummernpflichtig, Arbeitsplan freigegeben, Nicht in Ersatzteilliste, Bestand, Verkaufsstart, Auslaufdatum
• Produkte zusätzlich: Produktseite (URL), Nicht im Konfigurator
• Projekte zusätzlich: Teaser, Aktuelle Position

Bekommt ein neues Produkt oder Projekt keinen Slug, vergibt das PIM einen: „Kennung „…“ automatisch vergeben.“

Datumswerte im Format TT.MM.JJJJ. Ja/Nein-Werte als ja/nein, 1/0 oder x.

Händler, Kontakte, Medien, Preise als eigene Datensätze und Taxonomien lassen sich hier nicht importieren.

3. Testlauf

„Testlauf starten“ prüft jede Zeile, ohne etwas zu speichern. Der Lauf läuft im Hintergrund; der Fortschritt steht als „… von … Zeilen“ da.

Das Ergebnis zeigt je Zeile: Zeile, Schlüssel, Ergebnis, Änderungen und Hinweise. Filtern Sie nach „Neu und geändert“, „Neu“, „Geändert“, „Unverändert“, „Übersprungen“, „Fehler“ oder „Alle“. Angezeigt werden höchstens 100 Zeilen.

Typische Fehler:

• derselbe Schlüssel zweimal in der Datei
• ein Schlüssel passt zu mehreren Datensätzen („nicht eindeutig“)
• falsches Datums- oder Ja/Nein-Format
• „Neue Artikel brauchen das Recht, Averp-Felder zu bearbeiten.“

4. Import

„Import starten“ ist nur aktiv, wenn

• der Testlauf zur aktuellen Zuordnung passt, und
• mindestens eine Zeile angelegt oder geändert würde.

Ändern Sie nach dem Testlauf noch etwas an Zuordnung oder Einstellungen, verlangt das PIM einen neuen Testlauf: „Zuordnung oder Einstellungen wurden nach dem Testlauf geändert. Bitte den Testlauf wiederholen, bevor du importierst.“

Vor dem Start fragt das PIM nach: „Import jetzt ausführen?“ mit der Zahl der neuen und geänderten Datensätze, genau wie im Testlauf.

• Jede Zeile wird einzeln gespeichert. Scheitert eine Zeile, laufen die anderen weiter.
• Jede Änderung steht danach unter Aktivitäten, mit Ihrem Namen.
• Am Ende: „Import abgeschlossen. Alle Änderungen stehen im Aktivitätsprotokoll.“

Averp-Recht

Einige Felder gehören dem ERP (AVERP): Nummer, deutsche Bezeichnung, Kurzbezeichnung und Beschreibung, Typcode, Preis, Preisliste, Verkaufsbasis, alle Warengruppen, Gewicht, Zolltarifnummer, Seriennummernpflicht, Arbeitsplan freigegeben, Bestand, Auslaufdatum.

Sie zu ändern erfordert das Recht „AVERP-Felder entsperren und ändern“. Standardmäßig haben es Super-Admin, Admin und Data Steward, Redakteure nicht.

Ohne dieses Recht gilt im Import:

• Die Felder sind als „nur mit Averp-Recht“ gesperrt und fallen aus der Zuordnung. Zum Abgleich dürfen Sie Schlüsselfelder trotzdem nutzen.
• Werte für diese Felder werden übersprungen.
• Neue Artikel und Ersatzteile können Sie nicht anlegen; die Zeile wird zum Fehler.

Aufräumen

Abgeschlossene Importläufe und ihre hochgeladenen Dateien werden nach 30 Tagen vom Protokoll-Archiv entfernt.

Daten aus dem alten Pimcore-System werden nicht über diese Seite, sondern von Entwicklern per Befehl übernommen (siehe Import-Befehle).