Zum Inhalt springen

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

Aus HTK Wiki
Keine Bearbeitungszusammenfassung
Versionshinweis auf 5.2026.0915.1 gesetzt
 
(6 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
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 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.


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:
''Multiselektions-Attribute, die Option „Vorhandene Werte überschreiben" und die Sicherung der Attributwerte gibt es ab Client-Version 5.2026.0915.1.''


Schritt 1: Vorbereitung der Importvorlage
== Dateiformat ==
Erstellen Sie eine Importvorlage, indem Sie Exportdaten generieren. Nutzen Sie dazu den "OmniSeller Export Wizard".


Schritt 2: Importvorlage nutzen
Semikolon-getrennte [[OmniSeller:CSV-Datei|CSV-Datei]] mit Spaltenüberschriften in der ersten Zeile. Die Spalten werden anhand der Überschriften erkannt:
Klicken Sie auf "Import Vorlage erstellen", um die erzeugte Importvorlage zu verwenden.


Schritt 3: Import von Kurzund Langtexten sowie Setzuordnungen
* '''Pflicht:''' <code>AID</code> (Artikelnummer) und <code>SET</code> oder <code>FEATURE_GROUP</code> (Name des Sets)
Importieren Sie Kurzund Langtexte für verschiedene Sprachen.
* '''Für den Textimport zusätzlich Pflicht:''' <code>VARIATION</code> (AusprägungID, <code>0</code> für den Hauptartikel)
Importieren Sie Setzuordnungen für die Artikel und legen Sie fest, ob vorhandene Zuordnungen überschrieben werden sollen, wenn bereits ein Set vorhanden ist.
* '''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)


Schritt 4: Import der Attribute
'''Wichtig:''' Diese Spalten müssen '''vor''' der Spalte <code>SET</code> stehen. Rechts von <code>SET</code> werden nur noch Attribute gelesen.
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 und Attribute
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.
Stellen Sie sicher, dass Ihre Importdatei eine Excel-kompatible CSV-Datei ist.


Schritt 6: Neue Attribute
Beispiel:
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.
<pre>
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
</pre>


Schritt 7: Starten des Imports
'''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.
Klicken Sie auf "Start CSV Import", um den Importvorgang zu beginnen.


Schritt 8: Zusatzmeldungen (optional)
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).
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.


Schritt 9: Nach dem Import
== Artikel-Zuordnung ==
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.
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 die Attributwerte und für die Texte, wenn die Datei keine Spalte <code>LANGUAGE</code> 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 <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 ==
 
* '''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 (<code>Rot, Blau</code>). Werte, die in der Werteliste noch fehlen, werden angelegt. Die Werteliste selbst wird nie gelöscht.
* 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 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, Texte). Damit die Änderungen in den Portalen ankommen, die betroffenen Artikel anschließend hochladen.

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

OmniSeller PIM Import von Stammdaten und Attributen

PIM Import

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 ErweitertSicherungen…) 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.