Dokumentation

Upload der XML

Maximal 1 Upload ( bei erneutem Upload überschnreibt es die bisher hochgeladene XML )
XSD Schema validation-errors werden direkt nach dem Upload angezeigt, falls vorhanden
Semantische Fehler im XML werden bei interner Verarbeitung des XMLs erfasst und der Upload als fehlerhaft markiert

Verarbeitung der XML

Der Key <importId>...</importId> ist ein Pflichtfeld und muss angegeben werden. Wenn eine ImportID gesetzt wurde muss der Key hasChanges true sein ( <hasChanges>true</hasChanges> ), ansonsten wird kein update auf diesem Inserat vorgenommen.
Hat ein Inserat eine ImportID, kann aber nicht bei uns im System gefunden werden ( gemapped ), wird ein neues Inserat unabhängig von dem Status 'hasChanges' angelegt .
Car (FahrzeugDB) wird über die Plaintext-Eingabe des Nutzers gemapped. Wenn ein Treffer gefunden wurde, wird dieses Car verwendet, ansonsten ein neues angelegt welches erst durch die Redaktion geprüft werden muss, bevor es freigeschaltet wird.
Wird ein neuer FahrzeugDB Typ angelegt mit einem Baujahr das zwischen mehreren FahrzeugDB Typen liegt, so wird der zuletzt angelegte FahrzeugDB Typ bevorzugt.
Sobald ein Inserat in unser System aufgenommen wurde, werden über den XML Import Änderungen am FahrzeugDB Typ nicht mehr über den nächsten XML überschrieben ( FahrzeugDB ist App Master )
Bilder/Dateien müssen erreichbare URLs haben. Eine Zuordnung der Bilder findet per Hash auf den Binary statt. Sollte also auf http://www.picture.com/picture1 eine Datei abgelegt sein, mit der initial ein Inserat angelegt wurde, wird später unter der selben URL ein neues Bild abgelegt. Ändert sich mit dem nächsten Einspielen der XML das Bild für das zugehörige Inserat ( wenn <hasChanges>true</hasChanges> ist auf dem Inserat ).
Sollte ein Inserat den Status 'published' haben, so wird es vor dem Veröffentlichen der Validierung unterzogen und bei fehlschlagen im 'draft' Status abgespeichert.
Die Position der Bilder im Inserat ergeben sich durch die Position der Bilder im XML von oben nach unten absteigend.

XSD Schemata

Schema	Description
import/carAd-1.0.xsd	Schema für das Import XML ...
vehicle/car-1.0.xsd	Schema für FahrzeugDB Eintrag ( Car )
vehicleAd/carAd-1.0.xsd	Schema für Inserat ( CarAd )
image-1.0.xsd	Schema für Bilder
asset-1.0.xsd	Schema für Assets ( File )
extra-1.0.xsd	Schema für Extras
location-1.0.xsd	Schema für Fahrzeug-Standort
contact-1.0.xsd	Schema für Ansprechpartner
translated-1.0.xsd	Schema für übersetzbaren Inhalt

Folgende Asset-Typen können hochgeladen werden

application/msword
application/rtc
application/rtf
text/plain
text/richtext
application/pdf
image/png
image/jpeg
image/jpg
image/gif