Inhaltsverzeichnis |
Die Systemkonfigurations-Datei ist die zentrale XML-Datei, die die Verbindung zu allen weiteren XML-Dateien herstellt. Nur der Pfad zu dieser Datei muss in OscWare zur Konfiguration der XML-Schnittstelle angegeben werden.
Die Datei muss nach einem vorgegebenen XML-Schema aufgebaut sein. Dieses ist in einer *.xsd-Datei abgebildet (Zum Download der *.xsd-Datei hier klicken). Nachdem eine Datei erstellt wurde, kann ihre Gültigkeit durch Validieren gegen das XML-Schema geprüft werden.
Beispiel Systemkonfigurations-Datei |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
<?xml version="1.0" encoding="utf-8"?> <SystemKonfiguration version="1.0" xmlns="http://NetConnections/XML/SystemKonfiguration/v1_0"> <SystemInstanz> <Name>easy_shop</Name> <Beschreibung>Easy Shop</Beschreibung> <Konfiguration> <Dateiname>config.xml</Dateiname> <Verbindungsart>FTP</Verbindungsart> <Server>ftp.abc.com</Server> <Verzeichnis>config</Verzeichnis> <Benutzername>easy</Benutzername> <Passwort>fovdafs</Passwort> </Konfiguration> <Import> <Typ>Artikel</Typ> <Version>1.0</Version> <Dateiname>product*.xml</Dateiname> <Verbindungsart>FTP</Verbindungsart> <Server>ftp.easy.com</Server> <Verzeichnis>product</Verzeichnis> <Sicherungsverzeichnis>product/done</Sicherungsverzeichnis> <Fehlerverzeichnis>product/failed</Fehlerverzeichnis> <Benutzername>easy</Benutzername> <Passwort>fovikjjk</Passwort> <TriggerDateinamenEndung>.complete</TriggerDateinamenEndung> <TriggerDateienSichern>false</TriggerDateienSichern> </Import> <Export> <Typ>Bestellungen</Typ> <Version>1.0</Version> <Dateiname>order*.xml</Dateiname> <Verbindungsart>FTP</Verbindungsart> <Server>ftp.easy.com</Server> <Verzeichnis>order</Verzeichnis> <Sicherungsverzeichnis>order/done</Sicherungsverzeichnis> <Fehlerverzeichnis>order/failed</Fehlerverzeichnis> <Benutzername>easy</Benutzername> <Passwort>fovkjkj</Passwort> <TriggerDateinamenEndung>.complete</TriggerDateinamenEndung> <TriggerDateienSichern>false</TriggerDateienSichern> </Export> </SystemInstanz> </SystemKonfiguration> |
Die Beschreibung der Elemente ist in mehrere Tabellen aufgeteilt. Jede Tabelle steht dabei – mit Ausnahme der ersten – für einen eigenen Datentyp. So hat das Element <Bestellung> in der ersten Tabelle beispielsweise den Datentyp “BestellungenTyp”. Ein Hyperlink führt Sie von dort direkt zur Tabelle mit der zugehörigen Beschreibung. |
Element |
Datentyp |
Bemerkung |
Regel |
<SystemKonfiguration> |
– |
▪Enthält alle Systemkonfigurations-Daten. ▪Enthält die Version des XML-Schemas. |
Pflichtangabe |
<SystemInstanz> |
Enthält die Elemente von “SystemTyp” |
Angabe beliebig oft, mind. 1 Mal |
Element |
Datentyp |
Bemerkung |
Regel |
<Name> |
String |
|
Pflichtangabe |
<Beschreibung> |
String |
|
Pflichtangabe |
<Konfiguration> |
Enthält die Elemente von “KonfigurationTransferartTyp” Die enthaltenen Elemente geben an, wo sich die Konfigurations-Datei befindet. |
Pflichtangabe |
|
<Export> |
Enthält die Elemente von “TransferartTyp” Die enthaltenen Elemente enthalten alle notwendigen Informationen über die Bestelldaten-Dateien. OscWare liest den angegebenen SystemartTyp ein und überträgt diesen in Ihr Warenwirtschaftssystem (z. B. Lexware). |
Angabe beliebig oft, mind. 1 Mal |
Element |
Datentyp |
Bemerkung |
Regel |
<Typ> |
|
Pflichtangabe |
|
<Version> |
Double |
|
Pflichtangabe |
<Dateiname> |
String |
Gibt an, mit welcher Zeichenkette die Namen aller Bestelldaten-Dateien beginnen sollen. |
Pflichtangabe |
<Verbindungsart> |
String |
Mögliche Angaben: ▪FTP ▪Lokal |
Pflichtangabe |
<Server> |
String |
|
Pflichtangabe |
<Modus> |
String |
Mögliche Angaben: ▪Aktiv ▪Passiv |
Pflichtangabe |
<Verzeichnis> |
String |
|
Pflichtangabe |
<SicherungsverzeichnisVerbindungsart> |
String |
Mögliche Angaben: ▪FTP ▪Lokal |
Optionale Angabe |
<Sicherungsverzeichnis> |
String |
Gibt an, in welchen Ordner die Bestelldaten-Dateien nach erfolgreichem Import bzw. Export verschoben werden sollen. |
Optionale Angabe |
<FehlerverzeichnisVerbindungsart> |
String |
Mögliche Angaben: ▪FTP ▪Lokal |
Optionale Angabe |
<Fehlerverzeichnis> |
String |
Gibt an, in welchen Ordner die Bestelldaten-Dateien nach fehlgeschlagenem Import bzw. Export verschoben werden sollen. Zusätzlich werden Log-Dateien mit demselben Dateinamen wie die Bestelldaten-Dateien erstellt. |
Pflichtangabe |
<Benutzername> |
String |
|
Pflichtangabe |
<Passwort> |
String |
|
Pflichtangabe |
<TriggerDateinamenEndung> |
String |
Nach erfolgreichem Upload der Bestelldaten-Dateien, muss je eine Trigger-Datei mit demselben Dateinamen wie die Bestelldaten-Datei manuell erstellt werden. Element gibt an, welche Endung die Trigger-Dateien haben. |
Pflichtangabe |
<TriggerDateienSichern> |
Boolean |
Gibt an, ob die Trigger-Dateien mit den zuhörigen Bestelldaten-Dateien in das Sicherungsverzeichnis bzw. Fehlerverzeichnis verschoben werden sollen. |
Optionale Angabe |
<XSLTVerzeichnis> |
String |
|
Optionale Angabe |
<XSLTDateiname> |
String |
|
Optionale Angabe |
Elemente in “KonfigurationTransferartTyp”
Element |
Datentyp |
Bemerkung |
Regel |
<Dateiname> |
String |
|
Pflichtangabe |
<Verbindungsart> |
String |
Mögliche Angaben: ▪FTP ▪Lokal |
Pflichtangabe |
<Server> |
String |
|
Pflichtangabe |
<Verzeichnis> |
String |
|
Pflichtangabe |
<Benutzername> |
String |
|
Pflichtangabe |
<Passwort> |
String |
|
Pflichtangabe |
Element |
Datentyp |
Bemerkung |
Regel |
<Artikel> |
String |
|
Pflichtangabe |
<Kunden> |
String |
|
Pflichtangabe |
<Bestellungen> |
String |
|
Pflichtangabe |