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.
Wir arbeiten mit Software von http://www.campus21.de.
Verantwortlich für angezeigte Daten ist der Webdomain-Eigentümer laut Impressum.