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

Aktuelle Version vom 24. August 2026, 11:51 Uhr

OmniSeller PIM Import von Stammdaten und Attributen

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 Import von Attributswerten) arbeitet der PIM Import über alle Attribute einer Datei hinweg.

Dateiformat

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

Pflicht: EAN oder SUPPLIER_AID (Artikel-Identifikation) sowie FEATURE_GROUP oder SET (Set-Name, markiert zugleich den Beginn des Attributbereichs)
Optional: AID, VARIATION (AusprägungID), TITLE/TITEL, SHORTTEXT/KURZTEXT, LONGTEXT/LANGTEXT, LANGUAGE/SPRACHE (Sprache je Zeile, sonst gilt die im Dialog gewählte Sprache)

Nach der FEATURE_GROUP/SET-Spalte folgen die Attribute in Dreiergruppen: FNAME_1, FUNIT_1, FVALUE_1, FNAME_2, … - 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.

Die einfachste Art, eine formatgerechte Datei zu bekommen: mit dem Export-Wizard eine Importvorlage aus vorhandenen Artikeln erzeugen (Schaltfläche „Import Vorlage erstellen") - der Export liefert genau die FNAME/FUNIT/FVALUE-Struktur.

Artikel-Zuordnung

Die Artikel werden über den EAN-Helper aufgelöst: SUPPLIER_AID (Herstellerartikelnummer) plus EAN ergeben Artikelnummer und AusprägungID im gewählten Mandanten. Alternativ kann die SUPPLIER_AID-Spalte direkt die Artikelnummer enthalten, die Ausprägung kommt dann aus der VARIATION-Spalte. Zeilen, deren Artikel nicht gefunden wird, werden übersprungen und in der Meldungsdatei protokolliert. 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).
Attribut-Typ für neue Attribute - TEXT oder MULTISELECTION: bestimmt, als was unbekannte Attribute angelegt werden.
zusätzlich Textimport durchführen (Lang- & Kurztext) - importiert Titel, Kurz- und Langtext aus den entsprechenden Spalten.
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.
Set-Zuordnungen der Artikel überschreiben - weist Artikeln das Set aus der Datei zu, auch wenn sie bereits einem anderen Set zugeordnet sind.
Zusatzmeldungen - ausführliche Meldungen zur Interpretation der Datei (nur zur Fehlersuche, verlangsamt den Import).

Verhalten beim Import

Fehlende Sets und Attribute werden angelegt, vorhandene Werte aktualisiert.
Multiselektions-Attribute werden rein ergänzend gepflegt: Werte, die in der Werteliste fehlen, werden angelegt und beim Artikel angehakt - gelöscht wird nichts.
Über die Tabelle oHTKAttributeValuesMultiSelectionElementsAlternatives können Multiselektions-Werte beim Import übersetzt werden (Originalwert aus der Datei → gewünschter Wert in der Werteliste).
Während der Verarbeitung wird die Datei in <Name>.wait umbenannt; der Fortschritt ist an einer .dat-Markerdatei im selben Ordner ablesbar.
Meldungen (nicht gefundene Artikel, Fehler) landen in <Datei>.<Datum>.Meldungen.txt neben der Importdatei.

Sicherung und Protokoll

Ab Client-Version 5.0.2026.0824e.

Jeder Lauf sichert automatisch den Stand jedes berührten Attributs beim ersten Schreibzugriff und protokolliert Datum, Benutzer, Quelle („PIM Import: <Dateiname>") 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 Import von Attributswerten.

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.

@@ Zeile 1: / Zeile 1: @@
-'''OmniSeller PIM Import von Stammdaten und Attributen'''
+'''OmniSeller PIM Import von Stammdaten und Attributen'''[[file:pim-import.png|300px|thumb|PIM Import]]
-Im OmniSeller PIM können Sie eine Vielzahl von Stammdaten für einen bestimmten Mandanten importieren. Um sicherzustellen, dass Ihr Importformat korrekt ist, sollten Sie zunächst eine Importvorlage erstellen, indem Sie einige Exportdaten mithilfe des "Export Wizards" generieren. Dazu können Sie die Schaltfläche "Import Vorlage erstellen" verwenden.
+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.
-Sobald Sie die CSV-Datei (siehe auch [[OmniSeller:CSV-Datei|https://wiki.htk.de/OmniSeller:CSV-Datei]]) im erforderlichen Format haben, können Sie eine breite Palette von Daten importieren. Hier sind die Schritte im Detail:
+== Dateiformat ==
-Schritt 1: Vorbereitung der Importvorlage:
+Semikolon-getrennte [[OmniSeller:CSV-Datei|CSV-Datei]] mit Spaltenüberschriften in der ersten Zeile. Die Spalten werden anhand der Überschriften erkannt:
-Erstellen Sie eine Importvorlage, indem Sie Exportdaten generieren. Nutzen Sie dazu den "OmniSeller Export Wizard".
-Schritt 2: Importvorlage nutzen:
+* '''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)
-Klicken Sie auf "Import Vorlage erstellen", um die erzeugte Importvorlage zu verwenden.
+* '''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)
-Schritt 3: Import von Kurz- und Langtexten sowie Setzuordnungen:
+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.
-Importieren Sie Kurz- und Langtexte für verschiedene Sprachen.
-Importieren Sie Setzuordnungen für die Artikel und legen Sie fest, ob vorhandene Zuordnungen überschrieben werden sollen, wenn bereits ein Set vorhanden ist.
-Schritt 4: Import der Attribute
+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.
-Der Kern des Imports liegt im Hinzufügen von Attributen. Hier müssen Sie entscheiden, ob leere Attribute in den Importdaten vorhanden sind und ob sie vorhandene Daten überschreiben sollen oder nicht. Dies können Sie durch Setzen eines Hakens bei "Leere Werte importieren" festlegen.
-Schritt 5: Dateiformat:Stellen Sie sicher, dass Ihre Importdatei eine Excel-kompatible [[OmniSeller:CSV-Datei|CSV-Datei]] ist.
+== Artikel-Zuordnung ==
-Schritt 6: Neue Attribute:
+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.
-Wenn in der Datei neue Attribute vorhanden sind, legen Sie fest, wie diese interpretiert werden sollen. Sie können festlegen, ob sie als "Selection" (Auswahllisten) oder "Text" interpretiert werden sollen.
-Schritt 7: Starten des Imports:
+== Optionen ==
-Klicken Sie auf "Start CSV Import", um den Importvorgang zu beginnen.
-Schritt 8: Zusatzmeldungen (optional):
+* '''Sprache''' - Zielsprache für Texte und sprachabhängige Attribute (sofern die Datei keine eigene Sprachspalte hat).
-Sie können Zusatzmeldungen einblenden, wenn Sie die Interpretation der Datei überprüfen oder zu Debugging-Zwecken benötigen. Beachten Sie jedoch, dass Zusatzmeldungen den Importvorgang verlangsamen können, daher sollten sie nicht immer verwendet werden.
+* '''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.
+* '''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.
+* '''Set-Zuordnungen der Artikel überschreiben''' - weist Artikeln das Set aus der Datei zu, auch wenn sie bereits einem anderen Set zugeordnet sind.
+* '''Zusatzmeldungen''' - ausführliche Meldungen zur Interpretation der Datei (nur zur Fehlersuche, verlangsamt den Import).
-Schritt 9: Nach dem Import:
+== Verhalten beim Import ==
-Nach einem erfolgreichen Import müssen die Daten überprüft werden.
-Wenn Sie die Artikel im Shop anzeigen möchten, können Sie diese mit der Schaltfläche "Upload" hochladen.
-Folgen Sie diesen Schritten, um PIM-Stammdaten und Attribute erfolgreich in OmniSeller zu importieren. Bitte beachten Sie, dass die Benutzeroberfläche und die genauen Schritte je nach Ihrer spezifischen OmniSeller-Implementierung variieren können.
+* Fehlende '''Sets''' und '''Attribute''' werden angelegt, vorhandene Werte aktualisiert.
+* '''Multiselektions-Attribute''' werden rein ergänzend gepflegt: Werte, die in der Werteliste fehlen, werden angelegt und beim Artikel angehakt - gelöscht wird nichts.
+* Über die Tabelle <code>oHTKAttributeValuesMultiSelectionElementsAlternatives</code> können Multiselektions-Werte beim Import übersetzt werden (Originalwert aus der Datei → gewünschter Wert in der Werteliste).
+* 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.
+* Meldungen (nicht gefundene Artikel, Fehler) landen in <code>&lt;Datei&gt;.&lt;Datum&gt;.Meldungen.txt</code> neben der Importdatei.
+== Sicherung und Protokoll ==
+''Ab Client-Version 5.0.2026.0824e.''
+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]].
+== 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.

Admin (Diskussion | Beiträge)