Import („PDU“-App)

Der Reiter „Import“ ist eines der Werkzeuge für die Massendatenpflege. Hier können .xslx- oder .csv-Dateien mit Produktdaten importiert werden. Auf diese Weise lassen sich zum Beispiel exportierte Produktdaten, die in einem Tabellenkalkulationsprogramm editiert wurden, wieder in das iPIM-System einspielen, um die Produktdaten dort entsprechend zu aktualisieren. Mehr erfahrenWichtig dabei ist, dass die Daten aus der Importdatei den jeweiligen Produkten und den dazugehörigen Attributen zugeordnet werden. Dies geschieht über ein sogenanntes Mapping. Weniger Informationen

Um einen problemlosen Import zu gewährleisten, sollten die Daten in der Importdatei als Text formatiert werden.

Über einen Dateiimport lassen sich auch Attributwerte löschen. Mehr dazu findet sich hier.

Datei über eine Importvorlage hochladen

Konfiguration

Der Importvorgang besteht aus drei einzelnen Schritten. Im ersten Schritt wird eine Importvorlage ausgewählte und die Importdatei wird in das iPIM-System geladen. Dazu wird wie folgt vorgegangen:

1. Über das „Importvorlage“-Menü eine Importvorlage auswählen.
   Die entsprechenden Einstellungen werden in die jeweiligen Felder geladen. Bei Bedarf lassen sich einige der Einstellungen über die jeweiligen Menüs anpassen.
2. Die Importdatei über den Ablagebereich ziehen und die Datei dort ablegen. Oder auf " Dateien durchsuchen" klicken, um die Importdatei über den Dateimanager aufzurufen.
   Die Datei wird in den Zwischenspeicher geladen und der entsprechende Dateiname wird unterhalb des Ablagebereichs eingeblendet.

• Um das Analysieren der Importdatei anzustoßen, auf den WEITER-Button klicken.
  Es wird eine Erfolgsmeldung eingeblendet und es folgt eine Weiterleitung zum nächsten Slider, wo die nächsten Schritte durchgeführt können. .
• Um die Konfiguration zurücksetzen, auf die „Menü“-Icon () klicken, um das dahinterliegende Aktionsmenü zu öffnen und im Aktionsmenü auf die Option „Neu“ klicken.

Um einen problemlosen Import zu gewährleisten, die Daten in der Importdatei als Text formatieren.

Syntax für den Attributimport

Attributwerte von Attributtypen wie einfache Zeichenketten- oder Zahlenattribute lassen sich einfach die Tabellenzellen einer Importdatei schreiben. Komplexere Attributtypen erfordern eine bestimmte Syntax, um beim Import korrekt verarbeitet zu werden. Die nachfolgende Tabelle liefert einen Überblick, wie Attributwerte in einer Importdatei abgebildet werden:

Attributtyp	Syntax	Beispiel
Datum Datum und Zeit	Attributwerte für Attribute dieser Typen sind in einer Importdatei nach dem Prinzip dd.mm.yyyy bzw. dd.mm.yyyy hh:mm:ss aufgebaut.
Komplex	Beim Import von Attributen dieses Typs werden die Werte für die untergeordneten Komplex-Definition-Attribute importiert und auf diese Attribute gemappt.
Meta-Attribut	Beim Import von Attributen dieses Typs werden die Werte für die untergeordneten Meta-Definition-Attribute importiert und auf diese Attribute gemappt.
Wahrheitswert (Boolean)	Attribute dieses Typs können zwei Zustände besitzen, wobei die entsprechenden Attributwerte in einer Importdatei gemäß der Syntax true/false, yes/no sowie ja/nein abgebildet werden können.
Wertemenge, mehrfach Wertemenge, einfach	Für den Import von Attributwerten eines Attributs mit mehrfacher Wertemenge werden in der Importdatei die Werte-IDs der jeweiligen Werte aufgeführt, wobei die einzelnen Werte-IDs durch Pipe-Zeichen (|) getrennt werden: Werte-ID|Werte-ID|Werte-ID… Der Import von Attributen mit einfacher Wertemenge funktioniert nach demselben Prinzip, wobei jedoch in der Importdatei nur eine Werte-ID pro Attribut aufgeführt wird. Hinweis: Sicherstellen, dass Werte-IDs und nicht Werte zu importiert werden, da der Import sonst nicht funktioniert.
Zahl, ganzzahlig Zahl, dezimal Zahl, prozentual	Für Attribute dieser Typen lassen sich die Werte einfach in die entsprechenden Zellen der Importdatei schreiben/einfügen. Dabei können Vor- und Nachkommastellen über Kommatar oder Punkte getrennt werden. Hinweis: Im Falle von Attributen, deren Werte mit meiner Maßeinheit importiert werden, besteht die Möglichkeit im Schritt „Mapping“ Maßeinheiten zuzuweisen, sofern die importierten Maßeinheiten nicht automatisch zugeordnet werden können.
Zahlenbereich, ganzzahlig Zahlenbereich, dezimal	Attributwerte für Attribute dieser Typen werden in einer Importdatei nach dem Prinzip Startwert-Endwert abgebildet. Start- und Endwert sind durch einen Bindestrichgetrennt. Vor- und Nachkommarstellen können durch Punkte oder Kommatar getrennt werden.
Zeichenkette, CMYK	Attributwerte für Attribute dieses Typs werden in einer Importdatei über Prozentangaben für die einzelnen Farbanteile abgebildet, zum Beispiel 0,100,100,0 für die Farbe Rot. Hinweis: Die Farbwerte werden ohne Prozent- und Leerzeichen angegeben.
Zeichenkette, HEX	Attributwerte für Attribute dieses Typs werden in einer Importdatei über einen drei- oder sechsstelligen Hexadezimal-Code abgebildet, zum Beispiel F00 bzw. FF0000 für die Farbe Rot.
Zeichenkette, lokalisiert Zeichenkette, nicht lokalisiert	Für Attribute dieses Typs lassen sich die Werte einfach in die entsprechenden Zellen der Importdatei schreiben.
Zusammensetzung, anteilig	Attributwerte für Attributwerte dieses Typs werden zum Beispiel im Fall von Inhaltsstoffen nach folgenden Prinzip aufgebaut: Anteil#Inhaltstoff-Werte-ID|Anteil#Inhaltstoff-Werte-ID|Anteil#Inhaltstoff-Werte-ID… Hinweis: Maßeinheiten werden in einer Importdatei nicht aufgeführt. Daher ergibt es Sinn, für das jeweilige iPIM-Attribut eine Standardmaßeinheit zu definieren. Alternativ können Maßeinheiten aber auch im Zuge des Mappings bestimmt werden.
Zusammensetzung, prozentual	Attributwerte für Attribute dieses Typs werden zum Beispiel im Fall einer Matrialzusammensetzung nach folgendem Prinzip aufgebaut: Prozentwert#Material-Werte-ID|Prozentwert#Material-Werte-ID|Prozentwert#Material-Werte-ID…

Um zu einer Liste der verfügbaren Attributypen und -bereiche zu gelangen, hier klicken.

Syntax für Taxonomie-Mapping

Über den Import lassen sich Produkte auf Kategorien einer Taxonomie mappen.

Erklärung	Beispiel
Die Syntax für eine Kategoriezuordung ist nach dem folgenden Prinzip aufgebaut: Versions-ID#Kategorie-ID

Wie lassen sich Produkte auf mehrere Kategorien mappen?
Um ein Produkt auf mehrere Kategorien zu mappen, müssen diese durch ein Pipe (|) getrennt werden.

Mapping

Im zweiten Schritt werden die Daten aus der hochgeladenen Importdatei mit den entsprechenden Produktdatensätzen in iPIM gemappt (d. h. zugeordnet). Das Mapping sorgt dafür, dass die Attributewerte der entsprechenden iPIM-Produktdatensätzen mit den jeweils passenden Daten der Importdatei überschrieben werden.

Automatische Zuordnung (Automapping) vornehmen

Über die Funktion „Automapping“ können die Spaltennamen der Importdatei automatisiert den entsprechenden iPIM-Attributen zugeordnet werden. Dazu wird wie folgt vorgegangen:

Falls nicht allen Spaltennamen der Importdatei passende iPIM-Attribute zugeordnet werden konnten, muss eine manuelle Zuordnung vorgenommen werden, bevor zum nächsten Schritt übergegangen werden kann.

Über die Property general.dimension.level.nar.adddims kann festgelegt werden, ob das Mapping von Produkten auf Sekundärtaxonomien auch deren Varianten automatisch einschließt. Wenn die Property auf „true“ gesetzt wird, werden die Varianten gemappt. Wenn die Property auf „false“ gesetzt wird, werden die Varianten nicht gemappt.

Manuelles Mapping vornehmen

Anstatt die Automapping-Funktion zu verwenden, können die einzelnen Spaltennamen der Importdatei auch manuell den entsprechenden iPIM-Attributen zugeordnet werden. Dazu wird wie folgt vorgegangen:

• In der Karte „Attribute“ sind alle verfügbaren iPIM-Attribute aufgelistet. Diese sind nach Attributbereichen und Typen kategorisiert. Darunter sind zum Beispiel Systemattribute für die Zuordnung zu den Primär-, Sekundär- und Sales-Kategorien oder zu den iPIM-Produkt-, Varianten- oder Artikelnummern. Hinzukommen kommen Preis-, Text- und Cross-Selling-Typen. Und es gibt die Bereiche Kategorie- und Standardattribute für die unterschiedlichsten Produktinformationen.
• Das manuelle Mapping kann auch verwendet werden, um verschiedene Attribute miteinander zu mappen. Das bedeutet, Benutzer können die Attributwerte eines Attributs exportieren und diese beim Reupload der Datei mit einem anderen Attribut des gleichen Attributtyps mappen.

Einzelne Mappings löschen

Über das Kontextmenü lässt sich das Mapping für einzelne Attribute wieder auflösen, um anschließend ein neues Mapping vorzunehmen. Um ein Mapping aufzulösen, wird wie folgt vorgegangen:

1. In der jeweiligen Zeile auf das gemappte iPIM-Attribut rechtsklicken, um das Kontextmenü aufzurufen.
2. Auf die Option „Zelleninhalt löschen“ klicken, um die Tabellenzelle zu leeren.

Vorschau

Im dritten Schritt wird eine Vorschau der gemappten Produkte, Attribute und Attributwerte gezeigt. In der rechten oberen Ecke wird die Anzahl der etwaigen Validierungsfehler angezeigt. An dieser Stelle lässt sich der Importvorgang abschließen:

Von der Tabelle aus lassen sich einzelne Produkte in der „Produktdetails“-App aufrufen. Dazu auf die zugehörige Produkt- oder Artikelnummer klicken. Anschließend wird das jeweilige Produkt in einem neuen Tab aufgerufen.

Neue Importvorlage erstellen

Falls es für eine Importdatei noch keine passende Importvorlage gibt, lässt sich im Zuge des Importvorgangs eine neue Importvorlage anlegen. Dazu wird wie folgt vorgegangen:

1. Optional: Alle Auswahl- und Eingabefelder leeren. Dazu auf das „Aktionsmenü“-Icon () klicken, um das dahinterliegende Aktionsmenü zu öffnen und hier auf die Option „Neu“ klicken.
   Alle Auswahl- und Eingabefelder werden geleert.
2. In das „Bezeichnung (ID)“-Feld einen Namen für die neue Importvorlage eingeben.
3. Über das „Format“-Menü ein Dateiformat auswählen.
4. Optional: Sofern aus dem „Format“-Menü die Auswahl „CSV“ getroffen wurde, über das „Kodierung“-Menü die in der Importdatei verwendete Zeichenkodierung auswählen.
5. Optional: Sofern aus dem „Format“-Menü die Auswahl „CSV“ getroffen wurde, in das „Trennzeichen“-Feld ein Trennzeichen eingeben.
6. Über das „Sprache“-Menü  eine Datensprache auswählen.
7. Über das „Kontext“-Menü eine Kontextebene auswählen.
8. Optional: Einen Haken bei der Checkbox „Privat“ setzen, um die Importvorlage als privat zu definieren (Seit Version 5.5.3)*.

*Private Importvorlagen lassen sich nur von dem Benutzer verwenden, der sie erstellt hat. Wenn die Checkbox nicht angehakt ist, ist eine Importvorlage öffentlich. Sie kann von allen Benutzern verwendet werden, denen dieselbe Benutzerrolle zugwiesen ist wie dem Ersteller.

Importvorlage anpassen

Um eine bestehende Importvorlage anzupassen, wird wie folgt vorgegangen:

Importvorlage löschen

Um eine bestehende Importvorlagen zu löschen, wird wie folgt vorgegangen:

FAQ

Why should the data in the import file be formatted as text?

In order to guarantee a flawless import, the data in the import file should be formatted as text.

Can attribute values also be deleted via a file import?

Yes, you can also delete attribute values via an upload of a file.

How can I map products to categories of a taxonomy?

The syntax for the category allocation is written according to the syntax version ID#category node ID. In order to map a product to multiple categories, you need to separate them by a pipe (|).

Who can use a private import template?

Private import templates can only be used by the user who created them. If the „Private“ checkbox is not ticked, an import template is public and can be used by all users who have been assigned the same user role as the creator.

According to which syntax are attribute values for „List of values, multiple“ attributes represented in an import file?

For the import of a List of values, multiple attribute, the value IDs of the respective values are written in the import file, whereby the value IDs are separated by a | character: Value ID|Value ID|Value ID… You need to make sure to import the value IDs and not the values, otherwise the import does not work.

Why does it make sense to specify a default unit of measurement for attributes with a unit of measurement?

Units of measurements are not included in the import file for attributes of the type „Composition, listed“. Hence, it makes sense to specify a default unit of measurement for the respective iPIM attribute, in case the imported units of measurement can’t be allocated automatically during the import. Alternatively, you can also allocate units of measurement in the „Mapping“ slider.

How are attribute values for „Character string, CMYK“ attributes represented in an import file?

Attribute values for attributes of this type are represented by the percentage values of the four colour shares, for example 0,100,100,0 for the colour red. The colour values are written without empty spaces and commas.