Mit der hier beschriebenen Funktion kannst du Artikeldaten, die in einer CSV-Datei vorliegen, in deinen Xentral Artikelstamm importieren. Der Import legt neue Artikel an oder überschreibt Daten vorhandener Artikel - je nachdem, ob die eindeutige ID, die du beim Import wählst, bereits in Xentral vorhanden ist oder nicht.
Du findest den CSV-Importer im Menü Einstellungen > Administration > Datenaustausch > CSV-Importer.
Der Import von Artikeldaten über den CSV-Importer läuft nach folgendem Prozess ab:
Klicke auf + CSV-Import erstellen, um einen neuen Import anzulegen:
Tip
Sobald du Importe angelegt hast, kannst du sie an dieser Stelle wiederfinden, bearbeiten und erneut ausführen.
Lege die allgemeinen Daten deines Imports an, um ihn später wiederfinden zu können und lade die CSV-Datei hoch:
-
Trage einen Namen und
-
eine Beschreibung ein, die dir bei der Identifikation des Imports helfen.
-
Um Artikeldaten zu importieren, wähle den Datentyp Artikel.
-
Füge deine CSV-Datei ein.
Note
Per Klick auf Zurücksetzen kannst du eine andere Datei hochladen. Beachte, dass die Inhalte in den vorhergehenden Feldern verloren gehen, bevor du das erste Mal gespeichert hast.
-
Unter den Erweiterten Einstellungen kannst du bei Bedarf Anpassungen an den Trennzeichen und Sonderzeichen vornehmen, falls die Spalten der Importdatei auf der rechten Seite nicht korrekt angezeigt werden.
-
Wähle eine oder mehrere Spalten, die als eindeutiger Bezeichner (Datenbank-ID) dienen.
Note
Beachte, dass eine in der CSV-Datei doppelt aufgeführte Artikelnummer trotz eines unterschiedlichen Bezeichners nur einmal importiert wird. Stelle daher sicher, dass in der CSV-Datei jede Artikelnummer nur einmal aufgeführt ist.
Sobald du auf Mit dem Mapping starten geklickt hast, werden die Daten in eine Vorschau geladen.
In der Vorschauliste stehen dir folgende allgemeine Schaltflächen zur Verfügung:
-
(1) Suchfeld: Ermöglicht die Suche nach einer Artikelnummer
-
(2) Filter: Hier kannst du die Vorschauliste nach einem oder mehreren Filterkriterien einschränken.
Important
Achte bei der Eingabe von Filterwerten auf eine korrekte Schreibweise einschließlich Groß-/Kleinschreibung.
-
(3) Anleitung öffnen: Hier bekommst du einen kurzen Überblick über die Importschritte.
-
(4) Schnellfilter: Filtert die Daten nach Spalten, die nicht zugeordnet sind oder nach Zeilen, die invalide Daten enthalten.
-
(5) Neu laden: Hiermit kannst du die Vorschau neu laden.
-
(6) Abschließen: Führt eine Validierung durch und ermöglicht den anschließenden Datenimport.
In der linken Spalte der Vorschau ist der Eindeutige Bezeichner aufgeführt, in unserem Beispiel die Artikelnummer. Daneben werden alle Spalten geladen, die im Xentral Artikelstamm zur Verfügung stehen. Rot hinterlegte Felder stellen Pflichtfelder dar und müssen im nächsten Schritt zugeordnet werden. Der Kennzeichner oben rechts zeigt dir dabei den Datenstatus an. Alle weißen Spalten sind optional. Für diese nimmst du eine Zuordnung vor, nur soweit du es möchtest:
Um eine Spaltenzuordnung zu konfigurieren, klicke auf die Schaltfläche neben dem Spaltentitel:
Im Feld Ursprünglicher Feldname werden dir die Spaltentitel aus der CSV-Datei angezeigt.
Wähle den Feldnamen aus, der der ausgewählten Xentral-Spalte entspricht und klicke auf Anwenden. Die Zuordnung wird dir in der Vorschau angezeigt:
Wiederhole das Vorgehen für alle Pflichtspalten und bei Bedarf weitere optionale Spalten.
Note
Bei der Zuordnung des Projekts ist die Eingabe der Projekt-ID erforderlich. Die Nutzung der Projektbezeichnung oder eines Leerzeichens ist nicht möglich.
Öffne die Projekte, um die jeweilige Projekt-ID zu ermitteln. Das geht am Schnellsten über die Smart Search:
In der Projektübersicht klickst du auf das Projekt, dessen Projekt-ID du herausfinden möchtest, um es zu öffnen. Lies anschließend die Projekt-ID in der URL ab:
Klicke auf die Schaltfläche neben dem Spaltentitel Projekt ID. Wähle den Spaltennamen der CSV-Datei aus, in der die Projekt-ID steht, und klicke auf Anwenden. Die Zuordnung wird dir in der Vorschau angezeigt.
Note
Falls die Projekt-ID nicht in deiner CSV-Datei enthalten ist, nutze die Zuordnung von benutzerdefiniertem Text, die in dem folgenden Abschnitt beschrieben ist.
Falls du einer Spalte Daten zuweisen möchtest, für die in der ursprünglichen CSV-Datei keine passende Spalte vorhanden ist, kannst du beim Mapping die Auswahl Benutzerdefinierter Text nutzen.
Klicke auf die Schaltfläche neben dem Spaltentitel, um die Zuordnung zu öffnen. Wähle im Feld Ursprünglicher Feldname die Option Benutzerdefinierter Text aus und trage den zutreffenden Wert in das Feld daneben ein. In diesem Beispiel ordnen wir auf diese Weise die Projekt-ID zu:
Mit Hilfe der so genannten Transformer-Funktionen kannst du Daten aus der CSV-Datei vor dem Importieren anpassen oder bereinigen.
Du kannst die Daten auf Basis einer selbst definierten Regel anpassen. Die Regel trägst du einmal je Spalte ein. Sie wirkt sich dann auf alle Datenzeilen aus, für die die Regel zutrifft.
Um eine Regel einzutragen, klicke erneut auf die Schaltfläche neben dem Spaltentitel und anschließend auf Schritt hinzufügen:
Wähle einen Konfigurationstypen aus, mit dem du die Daten anpassen möchtest und klicke auf Übernehmen:
Folgende Konfigurationstypen stehen zur Verfügung:
-
HTML entfernen: Hiermit entfernst HTML-Tags aus einem String.
Tip
Beispiel: Dein Inhalt des Feldes ist “<p>Text</p>”, nach dem Transformieren ist es noch “Text”.
-
Weißraum entfernen: Diese Aktion entfernt Leerzeichen, die vor oder nach dem Inhalt stehen (jedoch keine Leerzeichen innerhalb der Zeichenkette).
-
Text ersetzen: Hiermit kannst du eine beliebige Zeichenkette durch eine andere ersetzen. So kannst du z. B. auch Leerzeichen innerhalb einer Zeichenkette entfernen.
-
Feld anhängen: Dies kannst du nutzen, um z. B. eine bestimmte Zeichenfolge an die im Feld vorhandenen Daten anzuhängen.
-
Wert festlegen: So kannst du einen festen Wert in die Spalte eintragen.
-
Bedingung: Auf diese Weise kannst du Daten vom System nach einer vorgegebenen Bedingung eintragen lassen.
Tip
Beispiel: Du kannst das System z. B. mit Hilfe der Bedingung folgende Anweisung ausführen lassen: “WENN die Artikelnummer das Prefix “HW” hat, DANN trage in die Projekt ID den Wert 5 ein.”
Je nach Konfigurationstyp kannst du weitere Angaben machen.
Tip
Die Funktion kannst du z. B. nutzen, wenn deine Artikelnummern in der CSV-Datei das Prefix “ART” haben, das du in Xentral stattdessen gerne als “PN” einfügen möchtest.
Bei Bedarf kannst du weitere Konfigurationstypen ergänzen, indem du erneut auf Schritt hinzufügen klickst und das Vorgehen mit einem anderen Konfigurationstypen wiederholst. So kannst du mehrere Änderungen / Ersetzungen kombinieren:
Sobald du alle gewünschten Konfigurationstypen definiert hast, bestätige per Klick auf Anwenden:
Die Vorschau zeigt dir die angepassten Daten, wie sie in Xentral übernommen werden.
Falls du eine Transformation nochmal anpassen oder wieder entfernen möchtest, klicke erneut auf die Schaltfläche neben dem Spaltentitel, um zum Transformations-Workflow zu gelangen. Dort kannst du
-
(1) Schritte wieder entfernen,
-
(2) erneut zum Bearbeiten öffnen oder
-
(3) neue Schritte hinzufügen.
Bestätige Änderungen per Klick auf Anwenden.
Ergänzend zur regelbasierten Transformation kannst du einzelne Datensätze manuell füllen. Doppelklicke dazu einfach in ein anzupassendes Datenfeld, tippe den Zielwert ein und bestätige mit der Enter-Taste oder dem grünen Haken:
Eine solche Änderung kannst du ganz einfach per Klick auf den Zurück-Pfeil zurücksetzen:
Sobald alle Daten in der Vorschau so vorliegen, wie du es benötigst und keine invaliden Daten mehr angezeigt werden, kannst du mit dem Import starten. Klicke dazu zunächst auf Abschließen:
Das System führt eine Datenvalidierung durch. Wenn keine invaliden Daten gefunden wurden, erhältst du eine grüne Erfolgsmeldung und kannst den Import starten:
Important
Sollten einzelne Datenfelder noch nicht ausreichend zugeordnet worden sein, bekommst du eine gelbe Meldung. In diesem Fall wird per Klick auf Import starten nur der positiv validierte Teil der Daten importiert, die anderen Datensätze warten auf Korrektur.
Nachdem du auf Import starten geklickt hast, startet der Import im Hintergrund und du gelangst automatisch auf die Statusseite. Dort kannst du die Ansicht über die Filter oben einschränken und den Status über die Schaltfläche rechts aktualisieren:
Nach erfolgreichem Abschluss des Imports ist der Status für alle Datensätze grün:
Note
Nach dem Start des Imports kannst Du diese Seite jederzeit schließen. Der Import läuft im Hintergrund weiter, solange noch Datensätze übrig sind. Du kannst jederzeit über die CSV-Importer Übersicht zum Reporting zurückkehren und den Status verfolgen.