OmniSeller:PIM Import - Stammdaten und Attributsimport: Unterschied zwischen den Versionen

Aktuelle Version vom 15. September 2026, 12:17 Uhr

OmniSeller PIM Import von Stammdaten und Attributen

Der PIM Import (Schaltfläche PIM Import im Ribbon) importiert Texte und Attributwerte für viele Artikel auf einmal aus einer CSV-Datei - Titel, Kurz- und Langtexte und beliebig viele Attribute je Artikel, auch Multiselektions-Attribute. Anders als der Import im Attribut-bearbeiten-Fenster (siehe Import von Attributswerten) arbeitet der PIM Import über alle Attribute einer Datei hinweg.

Multiselektions-Attribute, die Option „Vorhandene Werte überschreiben" und die Sicherung der Attributwerte gibt es ab Client-Version 5.2026.0915.1.

Dateiformat

Semikolon-getrennte CSV-Datei mit Spaltenüberschriften in der ersten Zeile. Die Spalten werden anhand der Überschriften erkannt:

Pflicht: AID (Artikelnummer) und SET oder FEATURE_GROUP (Name des Sets)
Für den Textimport zusätzlich Pflicht: VARIATION (AusprägungID, 0 für den Hauptartikel)
Optional: EAN, TITLE/TITEL, SHORTTEXT/KURZTEXT, LONGTEXT/LANGTEXT, LANGUAGE/SPRACHE (Sprache der Texte je Zeile)

Wichtig: Diese Spalten müssen vor der Spalte SET stehen. Rechts von SET werden nur noch Attribute gelesen.

Die Attribute folgen in Gruppen: FNAME_1 (technischer Attributname), FVALUE_1 (Wert) und optional FUNIT_1 (Einheit), danach FNAME_2, FVALUE_2 usw. Eine Einheit wird an den Wert angehängt („Wert Einheit"), bei Multiselektions-Attributen nicht. Ist der Attributname oder der Wert leer, wird das Attribut in dieser Zeile übersprungen.

Beispiel:

AID;EAN;VARIATION;LANGUAGE;SHORTTEXT;LONGTEXT;SET;FNAME_1;FVALUE_1;FNAME_2;FVALUE_2
10001;;0;DE;Kurzbeschreibung;<p>Beschreibung</p>;Standard;META_Title;Seitentitel;Farbe;Rot, Blau

Zeichensatz: Die Datei als UTF-8 speichern, in Excel über „CSV UTF-8 (durch Trennzeichen getrennt)". Dateien aus dem Export-Wizard sind ANSI-kodiert und sollten vor dem Import einmal in Excel geöffnet und so gespeichert werden, sonst gehen Umlaute in den Attributwerten verloren.

Eine formatgerechte Datei mit vorhandenen Artikeln liefert der Export-Wizard (Schaltfläche „Importvorlage erstellen" im Import-Dialog). Der Export schreibt eine Zeile je Sprache; für den Import der Attribute reicht eine Zeile je Artikel (siehe unten).

Artikel-Zuordnung

Die Spalte AID enthält die Artikelnummer, die Spalte VARIATION die AusprägungID.

Texte werden je Zeile importiert, in der Sprache aus der Spalte LANGUAGE oder, ohne diese Spalte, in der im Dialog gewählten Sprache.
Attributwerte werden nur für Hauptartikel (Ausprägung 0) und immer in der im Dialog gewählten Sprache importiert. Stehen mehrere Zeilen zu einer Artikelnummer in der Datei, gilt für die Attribute die letzte Zeile.
Artikel, die im PIM noch keinen Eintrag haben, werden beim Textimport angelegt. Ohne Textimport werden Attributwerte nur für Artikel importiert, die im PIM schon vorhanden sind.
Die Artikelnummer wird nicht gegen das ERP geprüft. Eine falsche Artikelnummer erzeugt beim Textimport einen PIM-Eintrag ohne ERP-Artikel. Der Import legt keine Artikel im ERP an.

Optionen

Sprache - Zielsprache für die Attributwerte und für die Texte, wenn die Datei keine Spalte LANGUAGE hat.
zusätzlich Textimport durchführen (Lang- & Kurztext) - importiert Titel, Kurz- und Langtext aus den entsprechenden Spalten. Ohne Häkchen werden nur Attributwerte importiert.
Vorhandene Werte überschreiben (Standard: an)
- an: Vorhandene Attributwerte, Titel und Texte werden durch die Werte aus der Datei ersetzt. Bei Multiselektions-Attributen werden die bisherigen Haken der importierten Artikel durch die Werte aus der Datei ersetzt.
- aus: Nur leere Attributwerte, Titel und Texte werden gefüllt, vorhandene bleiben stehen. Bei Multiselektions-Attributen werden die Werte aus der Datei zusätzlich angehakt.
Leere Werte importieren (überschreiben) - Zeilen mit leerer SET-Spalte werden beim Textimport trotzdem verarbeitet. Leere Zellen überschreiben auch mit dieser Option keine vorhandenen Inhalte.
Set-Zuordnungen der Artikel überschreiben - hat derzeit keine Wirkung, die Set-Zuordnung vorhandener Artikel bleibt unverändert.

Verhalten beim Import

Leere Zellen ändern nichts: Ein leerer oder fehlender Titel, Text oder Attributwert überschreibt keinen vorhandenen Inhalt.
Attribute müssen im PIM angelegt sein. Gesucht wird über den technischen Namen, ersatzweise über die Beschreibung. Unbekannte Attribute werden übersprungen, beim ersten Vorkommen erscheint eine Meldung.
Sets: Unbekannte Set-Namen werden beim Textimport als neues Set angelegt.
Multiselektions-Attribute: Mehrere Werte in einer Zelle durch Komma trennen (Rot, Blau). Werte, die in der Werteliste noch fehlen, werden angelegt. Die Werteliste selbst wird nie gelöscht.
Während der Verarbeitung wird die Datei in <Name>.wait umbenannt, der Fortschritt ist an einer .dat-Markerdatei im selben Ordner ablesbar. Nach dem Import liegt die Datei im Unterordner Archiv.
Meldungen (z. B. Zeilen ohne Artikelnummer) landen in <Datei>.<Datum>.Meldungen.txt neben der Importdatei.

Sicherung und Protokoll

Jeder Lauf sichert den Stand jedes berührten Attributs vor dem ersten Schreibzugriff und protokolliert Datum, Benutzer, Quelle („PIM Import: <Dateiname>") und Ergebnis (Zeilen pro Attribut, Abbruch). Das gilt für alle Attributtypen einschließlich Multiselektion. Die Läufe erscheinen in der Sicherungs-Historie des jeweiligen Attributs (Attribut bearbeiten → Import → Reiter Erweitert → Sicherungen…) und sind dort innerhalb von 14 Tagen wiederherstellbar - Details siehe Import von Attributswerten.

Titel, Kurz- und Langtexte werden nicht gesichert.

Nach dem Import

Importierte Daten stichprobenartig prüfen (Attributwerte, Texte). Damit die Änderungen in den Portalen ankommen, die betroffenen Artikel anschließend hochladen.

@@ Zeile 1: / Zeile 1: @@
 '''OmniSeller PIM Import von Stammdaten und Attributen'''[[file:pim-import.png|300px|thumb|PIM Import]]
-Der PIM Import (Schaltfläche '''PIM Import''' im Ribbon) importiert Stammdaten und Attributwerte für viele Artikel auf einmal aus einer CSV-Datei - Titel, Kurz- und Langtexte, Set-Zuordnungen und beliebig viele Attribute je Artikel. Fehlende Sets und Attribute werden dabei automatisch angelegt. Anders als der Import im Attribut-bearbeiten-Fenster (siehe [[OmniSeller:Import von Attributswerten|Import von Attributswerten]]) arbeitet der PIM Import über alle Attribute einer Datei hinweg.
+Der PIM Import (Schaltfläche '''PIM Import''' im Ribbon) importiert Texte und Attributwerte für viele Artikel auf einmal aus einer CSV-Datei - Titel, Kurz- und Langtexte und beliebig viele Attribute je Artikel, auch Multiselektions-Attribute. Anders als der Import im Attribut-bearbeiten-Fenster (siehe [[OmniSeller:Import von Attributswerten|Import von Attributswerten]]) arbeitet der PIM Import über alle Attribute einer Datei hinweg.
+''Multiselektions-Attribute, die Option „Vorhandene Werte überschreiben" und die Sicherung der Attributwerte gibt es ab Client-Version 5.2026.0915.1.''
 == Dateiformat ==
@@ Zeile 7: / Zeile 9: @@
 Semikolon-getrennte [[OmniSeller:CSV-Datei|CSV-Datei]] mit Spaltenüberschriften in der ersten Zeile. Die Spalten werden anhand der Überschriften erkannt:
-* '''Pflicht:''' <code>EAN</code> oder <code>SUPPLIER_AID</code> (Artikel-Identifikation) sowie <code>FEATURE_GROUP</code> oder <code>SET</code> (Set-Name, markiert zugleich den Beginn des Attributbereichs)
+* '''Pflicht:''' <code>AID</code> (Artikelnummer) und <code>SET</code> oder <code>FEATURE_GROUP</code> (Name des Sets)
-* '''Optional:''' <code>AID</code>, <code>VARIATION</code> (AusprägungID), <code>TITLE</code>/<code>TITEL</code>, <code>SHORTTEXT</code>/<code>KURZTEXT</code>, <code>LONGTEXT</code>/<code>LANGTEXT</code>, <code>LANGUAGE</code>/<code>SPRACHE</code> (Sprache je Zeile, sonst gilt die im Dialog gewählte Sprache)
+* '''Für den Textimport zusätzlich Pflicht:''' <code>VARIATION</code> (AusprägungID, <code>0</code> für den Hauptartikel)
+* '''Optional:''' <code>EAN</code>, <code>TITLE</code>/<code>TITEL</code>, <code>SHORTTEXT</code>/<code>KURZTEXT</code>, <code>LONGTEXT</code>/<code>LANGTEXT</code>, <code>LANGUAGE</code>/<code>SPRACHE</code> (Sprache der Texte je Zeile)
+'''Wichtig:''' Diese Spalten müssen '''vor''' der Spalte <code>SET</code> stehen. Rechts von <code>SET</code> werden nur noch Attribute gelesen.
+Die Attribute folgen in Gruppen: <code>FNAME_1</code> (technischer Attributname), <code>FVALUE_1</code> (Wert) und optional <code>FUNIT_1</code> (Einheit), danach <code>FNAME_2</code>, <code>FVALUE_2</code> usw. Eine Einheit wird an den Wert angehängt („Wert Einheit"), bei Multiselektions-Attributen nicht. Ist der Attributname oder der Wert leer, wird das Attribut in dieser Zeile übersprungen.
+Beispiel:
+<pre>
+AID;EAN;VARIATION;LANGUAGE;SHORTTEXT;LONGTEXT;SET;FNAME_1;FVALUE_1;FNAME_2;FVALUE_2
+;;0;DE;Kurzbeschreibung;<p>Beschreibung</p>;Standard;META_Title;Seitentitel;Farbe;Rot, Blau
+</pre>
-Nach der <code>FEATURE_GROUP</code>/<code>SET</code>-Spalte folgen die Attribute in '''Dreiergruppen''': <code>FNAME_1</code>, <code>FUNIT_1</code>, <code>FVALUE_1</code>, <code>FNAME_2</code>, … - also je Attribut Name, Einheit und Wert. Wert und Einheit werden beim Import zu einem Attributwert kombiniert („Wert Einheit"). Eine leere Namensspalte beendet den Attributbereich der Zeile.
+'''Zeichensatz:''' Die Datei als UTF-8 speichern, in Excel über „CSV UTF-8 (durch Trennzeichen getrennt)". Dateien aus dem [[OmniSeller:Export-Wizard|Export-Wizard]] sind ANSI-kodiert und sollten vor dem Import einmal in Excel geöffnet und so gespeichert werden, sonst gehen Umlaute in den Attributwerten verloren.
-Die einfachste Art, eine formatgerechte Datei zu bekommen: mit dem [[OmniSeller:Export-Wizard|Export-Wizard]] eine Importvorlage aus vorhandenen Artikeln erzeugen (Schaltfläche „Import Vorlage erstellen") - der Export liefert genau die FNAME/FUNIT/FVALUE-Struktur.
+Eine formatgerechte Datei mit vorhandenen Artikeln liefert der Export-Wizard (Schaltfläche „Importvorlage erstellen" im Import-Dialog). Der Export schreibt eine Zeile je Sprache; für den Import der Attribute reicht eine Zeile je Artikel (siehe unten).
 == Artikel-Zuordnung ==
-Die Artikel werden über den EAN-Helper aufgelöst: <code>SUPPLIER_AID</code> (Herstellerartikelnummer) plus <code>EAN</code> ergeben Artikelnummer und AusprägungID im gewählten Mandanten. Alternativ kann die <code>SUPPLIER_AID</code>-Spalte direkt die Artikelnummer enthalten, die Ausprägung kommt dann aus der <code>VARIATION</code>-Spalte. Zeilen, deren Artikel nicht gefunden wird, werden übersprungen und in der Meldungsdatei protokolliert. Der Import legt keine Artikel im ERP an.
+Die Spalte <code>AID</code> enthält die Artikelnummer, die Spalte <code>VARIATION</code> die AusprägungID.
+* '''Texte''' werden je Zeile importiert, in der Sprache aus der Spalte <code>LANGUAGE</code> oder, ohne diese Spalte, in der im Dialog gewählten Sprache.
+* '''Attributwerte''' werden nur für Hauptartikel (Ausprägung 0) und immer in der im Dialog gewählten Sprache importiert. Stehen mehrere Zeilen zu einer Artikelnummer in der Datei, gilt für die Attribute die letzte Zeile.
+* Artikel, die im PIM noch keinen Eintrag haben, werden beim Textimport angelegt. Ohne Textimport werden Attributwerte nur für Artikel importiert, die im PIM schon vorhanden sind.
+* Die Artikelnummer wird nicht gegen das ERP geprüft. Eine falsche Artikelnummer erzeugt beim Textimport einen PIM-Eintrag ohne ERP-Artikel. Der Import legt keine Artikel im ERP an.
 == Optionen ==
-* '''Sprache''' - Zielsprache für Texte und sprachabhängige Attribute (sofern die Datei keine eigene Sprachspalte hat).
+* '''Sprache''' - Zielsprache für die Attributwerte und für die Texte, wenn die Datei keine Spalte <code>LANGUAGE</code> hat.
-* '''Attribut-Typ für neue Attribute''' - <code>TEXT</code> oder <code>MULTISELECTION</code>: bestimmt, als was unbekannte Attribute angelegt werden.
+* '''zusätzlich Textimport durchführen (Lang- & Kurztext)''' - importiert Titel, Kurz- und Langtext aus den entsprechenden Spalten. Ohne Häkchen werden nur Attributwerte importiert.
-* '''zusätzlich Textimport durchführen (Lang- & Kurztext)''' - importiert Titel, Kurz- und Langtext aus den entsprechenden Spalten.
+* '''Vorhandene Werte überschreiben''' (Standard: an)
-* '''Leere Werte importieren (überschreiben)''' - ohne Haken werden leere Attributwerte in der Datei übersprungen (vorhandene Werte bleiben stehen); mit Haken überschreiben auch leere Werte den Bestand.
+** '''an:''' Vorhandene Attributwerte, Titel und Texte werden durch die Werte aus der Datei ersetzt. Bei Multiselektions-Attributen werden die bisherigen Haken der importierten Artikel durch die Werte aus der Datei ersetzt.
-* '''Set-Zuordnungen der Artikel überschreiben''' - weist Artikeln das Set aus der Datei zu, auch wenn sie bereits einem anderen Set zugeordnet sind.
+** '''aus:''' Nur leere Attributwerte, Titel und Texte werden gefüllt, vorhandene bleiben stehen. Bei Multiselektions-Attributen werden die Werte aus der Datei zusätzlich angehakt.
-* '''Zusatzmeldungen''' - ausführliche Meldungen zur Interpretation der Datei (nur zur Fehlersuche, verlangsamt den Import).
+* '''Leere Werte importieren (überschreiben)''' - Zeilen mit leerer <code>SET</code>-Spalte werden beim Textimport trotzdem verarbeitet. Leere Zellen überschreiben auch mit dieser Option keine vorhandenen Inhalte.
+* '''Set-Zuordnungen der Artikel überschreiben''' - hat derzeit keine Wirkung, die Set-Zuordnung vorhandener Artikel bleibt unverändert.
 == Verhalten beim Import ==
-* Fehlende '''Sets''' und '''Attribute''' werden angelegt, vorhandene Werte aktualisiert.
+* '''Leere Zellen ändern nichts:''' Ein leerer oder fehlender Titel, Text oder Attributwert überschreibt keinen vorhandenen Inhalt.
-* '''Multiselektions-Attribute''' werden rein ergänzend gepflegt: Werte, die in der Werteliste fehlen, werden angelegt und beim Artikel angehakt - gelöscht wird nichts.
+* '''Attribute''' müssen im PIM angelegt sein. Gesucht wird über den technischen Namen, ersatzweise über die Beschreibung. Unbekannte Attribute werden übersprungen, beim ersten Vorkommen erscheint eine Meldung.
-* Über die Tabelle <code>oHTKAttributeValuesMultiSelectionElementsAlternatives</code> können Multiselektions-Werte beim Import übersetzt werden (Originalwert aus der Datei → gewünschter Wert in der Werteliste).
+* '''Sets:''' Unbekannte Set-Namen werden beim Textimport als neues Set angelegt.
-* Während der Verarbeitung wird die Datei in <code>&lt;Name&gt;.wait</code> umbenannt; der Fortschritt ist an einer <code>.dat</code>-Markerdatei im selben Ordner ablesbar.
+* '''Multiselektions-Attribute:''' Mehrere Werte in einer Zelle durch Komma trennen (<code>Rot, Blau</code>). Werte, die in der Werteliste noch fehlen, werden angelegt. Die Werteliste selbst wird nie gelöscht.
-* Meldungen (nicht gefundene Artikel, Fehler) landen in <code>&lt;Datei&gt;.&lt;Datum&gt;.Meldungen.txt</code> neben der Importdatei.
+* Während der Verarbeitung wird die Datei in <code>&lt;Name&gt;.wait</code> umbenannt, der Fortschritt ist an einer <code>.dat</code>-Markerdatei im selben Ordner ablesbar. Nach dem Import liegt die Datei im Unterordner <code>Archiv</code>.
+* Meldungen (z. B. Zeilen ohne Artikelnummer) landen in <code>&lt;Datei&gt;.&lt;Datum&gt;.Meldungen.txt</code> neben der Importdatei.
 == Sicherung und Protokoll ==
-Jeder Lauf sichert automatisch den Stand jedes berührten Attributs beim ersten Schreibzugriff und protokolliert Datum, Benutzer, Quelle („PIM Import: &lt;Dateiname&gt;") und Ergebnis (Zeilen pro Attribut, Abbruch). Die Läufe erscheinen in der Sicherungs-Historie des jeweiligen Attributs (Attribut bearbeiten → Import → Reiter '''Erweitert''' → '''Sicherungen…''') und sind dort innerhalb von '''14 Tagen''' wiederherstellbar - Details siehe [[OmniSeller:Import von Attributswerten|Import von Attributswerten]].
+Jeder Lauf sichert den Stand jedes berührten Attributs vor dem ersten Schreibzugriff und protokolliert Datum, Benutzer, Quelle („PIM Import: &lt;Dateiname&gt;") und Ergebnis (Zeilen pro Attribut, Abbruch). Das gilt für alle Attributtypen einschließlich Multiselektion. Die Läufe erscheinen in der Sicherungs-Historie des jeweiligen Attributs (Attribut bearbeiten → Import → Reiter '''Erweitert''' → '''Sicherungen…''') und sind dort innerhalb von '''14 Tagen''' wiederherstellbar - Details siehe [[OmniSeller:Import von Attributswerten|Import von Attributswerten]].
+Titel, Kurz- und Langtexte werden nicht gesichert.
 == Nach dem Import ==
-Importierte Daten stichprobenartig prüfen (Attributwerte, Set-Zuordnungen, Texte). Damit die Änderungen in den Portalen ankommen, die betroffenen Artikel anschließend hochladen.
+Importierte Daten stichprobenartig prüfen (Attributwerte, Texte). Damit die Änderungen in den Portalen ankommen, die betroffenen Artikel anschließend hochladen.

Admin (Diskussion | Beiträge)