Anmelden

Dateiformat

Die Produktdaten werden als CSV-Format mit Kopfzeile exportiert. Die Kopfzeile identifiziert das Datenfeld. Bei den Datenfeldern wird unterschieden in:

  • Produkt: es handelt sich um ein Datenfeld des Produktstammdatensatzes. Diese Datenfelder sind beim Export immer anwesend.
  • Preis: es handelt sich um einen Preisbaustein. Die Ziffer gibt den Typ des Preisbausteines (Gebührenart). Die Anwesenheit der Preisbausteine ist optional, und wird in der Produktdefinition festgegelegt.
  • Parameter: es handelt sich um einen Parameterwert. Parameterwerte sind abhängig vom Ressourcentyp

Datenfeld (Spalte)

Typ

Erklärung

ProductName

Produkt

Produktbezeichnung

ProductNumber

Produkt

Offizielle Artikelnummer

ProductCode

Produkt

Internes Produktsymbol (Kürzel)

ProductId

Produkt

Primärschlüssel

PriceInfo

Produkt

Preisinformation in der Produktliste

ChargeCat1

Preis

Einmalgebühr bei Vertragsbeginn

ChargeCat2

Preis

Periodische Gebühr

[Produktparametername1]

Parameter

 

[Produktparametername2]

Parameter

 

...

Parameter

 

Weitere Hinweise

  • Aus einer exportierten Datei können Produkte (Zeilen) entfernt werden. Bei einem nachfolgenden Import werden diese Produkte nicht geändert.
  • Aus einer exportierten Datei können Werte (Spalten) entfernt werden, außer ProductId. Bei einem nachfolgenden Import werden diese Werte in den Produkten dann nicht geändert.
  • Werden in einer exportierten Datei Werte hinzugefügt, die das Produkt nicht besitzt, werden diese beim Import ignoriert. Es können somit keine Produktparameter oder Preisbaussteine hinzugefügt werden.

Wenn Produktdaten Umlaute oder spezielle Zeichen (z.B. € in der Preisinformation) enthalten, wird beim Export eine UTF8-kodierte Datei erzeugt. Diese Kodierung darf nicht geändert werden.

  • Viele Programme können mit der UTF8-Kodierung korrekt umgehen (z.B. aktuelles Notpad, Editor in MS Visual Studio).
  • MS Excel beläßt auch die UTF8-Kodierung der Datei, zeigt aber die betroffenden Zeichen nicht korrekt an. In diesem Fall dürfen die Zeichen nicht korrigiert werden, anderenfalls werden beim Import falschen Zeichen zurückgeschrieben
  • Excel reduziert beim Öffnen der Datei numerische Ausdrücke auf eine vereinfachte Form, z.B. 0,00 nach 0. Beim Import der Datei würden diese Ausdrücke geändert werden. Da es sich hier um Produktparameter handeln kann wo die Schreibweise beabsichtigt und signifikant ist, kann es zum Fehlverhalten des Produktes kommen!

Bedienung der Kommandozeile

Kommandozeilenwerkzeug: ProductService.DumpTool.exe
Beispiel:
ProductService.DumpTool.exe Export /File:dump_68-11.csv /SupplierId:68 /ResourceTypeId:11

Argument

Typ

Erklärung

< Command>

 

auszuführende Aktion: Export | Import

/File:...

string  

Dateiname oder Pfad

/Simulation

 

Der Sumulationsmodus dient der Überprüfung der Korrektheit der Daten beim Import, ohne dass Daten im System gespeichert werden. An der Ausgabe in der Kommandozeile können tatsächliche Änderungen angezeigt werden, die vorgenommen werden würden.

/SupplierId:...

int

Pflichtargument beim Export, Schlüssel des Lieferanten

/ResourceTypeId:...

int

Pflichtargument beim Export, Schlüssel des Ressourcentyps.

/ProductName:...

string

Suchbegriff für Produktnamen. Es kann nach Teilausdrücken in Produktnamen selektiert werden. Als Jokerzeichen für beliebige Zeichen ist % zu verwenden.

Hinweise

  • Dem Argumentnamen ist immer / vorangestellt, außer Command
  • Groß-/Kleinschreibung ist zu beachten.
  • Die Werte folgen nach : nach dem Argumentnamen.
  • Der Parameter Simulation ist nur bei Aktion Import relevant.
  • SupplierId, ResourceTypeId und ProductName sind nur bei Export relevant.
   
Top

Wir arbeiten mit Software von http://www.campus21.de.

Verantwortlich für angezeigte Daten ist der Webdomain-Eigentümer laut Impressum.

Suche