Schnittstellenbeschreibung. XML-Standards. cdmm

Transkript

1 Schnittstellenbeschreibung und XML-Standards Seite 1 von 7 Tel. +49(0) Fax. +49(0) info@.de

2 cdxi ist die XML-basierte Datenschnittstelle der. Die cdxi-schnittstelle dient dem standardisierten Austausch und dem organisierten Update von Produktinformationen und produktrelevanten Metadaten in EDV- und Datenbank-Systemen. Die cdxi Schnittstelle ist auf den Automotive After Service Market zugeschnitten und erleichtert die plattformübergreifende Bereitstellung von Produktdaten. Mit der cdxi-schnittstelle können ERP- und WaWi- Systeme sowie Online- und datenbankbasierte Print- Systeme gefüllt und geupdatet werden. Seite 2 von 7 Tel. +49(0) Fax. +49(0) info@.de

3 [WERTE] in den eckigen Klammern stehen Variablen/Wertebereiche, die einer bestimmten Funktion zugeordnet werden sollen. z. B. [locale_id] Mögliche Werte, die hier eingetragen werden können, wären z. B. Sprachen, die in unserem System unterstützt werden. Schemadatei PRODUCTS Diese Schemadatei schreibt vor, in welchen Feldern Angaben zu einem Produkt gemacht werden können. Dabei sind bestimmte Felder zwingend zu füllen, um das Produkt eindeutig in der Datenbank identifizieren zu können. Ebenso ist das Format der Daten (string, integer, boolean etc.) vorgegeben und einzuhalten. Zeichenketten müssen medienneutral sein. Verwenden Sie deshalb keine Tabellen oder ähnlich formatierte Daten. Benutzen Sie die optionalen Felder für weitere Informationen zum Produkt, die Sie für relevant halten (Siehe Abschnitt Detailsets). Feldergänzungen zur Schemadatei PRODUCTS: Datum Feldname Bezeichnung duty_tax_key Zolltarifnummer Ihre Produktdaten müssen stets gegen diese Schemadatei validiert werden können. LOCALE In dieser Datei sind die Sprachen hinterlegt, die unser System prinzipiell unterstützt. Die einzelnen Sprachen werden auf das entsprechende Produkt referenziert. Bitte beachten Sie die Verwendung von entsprechenden Sonderzeichen. Bitte beachten! Alle Angaben müssen kompatibel zur Unicode-Kodierung UTF-8 sein. Detailset UNITS In dieser Datei sind alle physikalischen Einheiten (z. B. m/s, mm²) bzw. Erläuterungen (Gebindegröße etc.) hinterlegt, die für die Beschreibung einer technischen Eigenschaft Ihres Produkts notwendig sind. Bitte beachten! Alle Angaben müssen kompatibel zur Unicode-Kodierung UTF-8 sein. Seite 3 von 7 Tel. +49(0) Fax. +49(0) info@.de

4 Detailset COLUMNS In dieser Datei stehen alle in unserem System verwendeten Bezeichnungen für technische Eigenschaften und physikalische Größen. Jeder Bezeichnung/Größe wird eine entsprechende Einheit zugewiesen. Dabei ist die Sortierung zu beachten. PRODUCTGROUPS Diese Datei enthält eine Auflistung aller in unserer Datenbank hinterlegten Produktgruppen. Wenn möglich, wählen Sie aus den vorgegebenen Produktgruppen aus, um Ihre Produkte entsprechend und eindeutig nachvollziehbar zuzuordnen. Selten kann es vorkommen, dass keine der hinterlegten Produktgruppen eine eindeutige Beschreibung für Ihr Produkt bietet. Setzen Sie sich in dem Fall bitte umgehend mit uns in Verbindung. Wir stellen Ihnen dann eine entsprechende Produktgruppe zur Verfügung. DETAILSETS Die Zuordnung der entsprechenden Detailsets erfolgt durch die Festlegung der Produktgruppe. In dem jeweiligen Detailset werden alle technisch relevanten Daten zu einem Produkt hinterlegt. Bitte beachten Sie hierzu die physikalisch korrekte Zuordnung von Größen und Einheiten. Formatierungen aller Art sind unnötig, verwenden Sie daher bitte keine Tausender-Trennung in Form eines Punkts, Kommas oder Leerzeichens bei großen Zahlen. Die Verwendung eines unpassenden Detailsets führt unter Umständen dazu, dass gewisse Angaben nicht dargestellt werden können. Testen Sie gegebenenfalls über die Produktgruppe, ob das zugehörige Detailset alle Informationen zur Verfügung stellt, die sie benötigen. Arbeitsbereiche Für die Kategorisierung ihrer Daten können Sie Arbeitsbereiche definieren, z. B. ob ein Produkt im Karosserie-Servicebereich angewendet werden kann oder nur für TÜV/DEKRA-Werkstätten zur Verfügung steht etc. Hersteller Einem Hersteller können mehrere Pool- oder Katalog-IDs zugeordnet sein. Um auf die Informationen über einen Herstellers zuzugreifen, benötigen Sie die zugehörige <customer id>. Seite 4 von 7 Tel. +49(0) Fax. +49(0) info@.de

5 DOWNLOAD von Produktdaten aus dem -Pool Sprachauswahl der Produktdaten über Herstellerauswahl über [locale_id] [pool_id] Über die Pool-ID werden die Produktdaten des jeweiligen Herstellers ausgelesen. Durch Ihr Login in unserem System stehen Ihnen nur die für Ihren Account freigegebenen Pool-IDs zur Verfügung. Die zu den Hersteller-Pools gehörigen IDs erhalten Sie nach Freigabe des Herstellers auf Anfrage von der als Liste für Ihre Unterlagen. Unter erhalten Sie auch ein entsprechendes XML-Dokument, dass die Pool- und Katalog-IDs der jeweiligen Hersteller beinhaltet. DOWNLOAD von Bildern/Dokumenten aus dem -Dateimanager Über den 40-stelligen Hash wird eine Datei eindeutig identifiziert. Ersetzen Sie <hash> durch den entsprechenden Hash aus dem XML-Dokument und Sie bekommen dieses Dokument zum Download angeboten. Der Hash verändert sich, sobald die Datei durch eine andere mit abweichendem Inhalt ersetzt wird. Dateiname und/oder Änderungs-/Erstellungsdatum sind hier irrelevant. Mittels diesem Link erhalten Sie ein Dokument als Bild, welches z. B. als Vorschau auf das Dokument genutzt werden kann. PDF-Dokumente werden über diesen Link in PNG- bzw. JPG-Dateien umgewandelt und angezeigt. Mit der Angabe der Dimensionen können Sie die Größe des zum Download angegebenen Bilds festlegen: <max_width> <max_height> max. Breite des Bilds in Pixeln max. Höhe des Bilds in Pixeln WICHTIGER HINWEIS: Der Internet Explorer kann erst ab Version 7.0 transparente PNGs darstellen. Ältere Versionen stellen PNG-Dateien mit transparentem Hintergrund als JPG-Datei mit weißem Hintergrund dar. Alternativ können Sie den Browser Mozilla-Firefox verwenden, da dieser in jeder Version PNGs richtig darstellen kann. Seite 5 von 7 Tel. +49(0) Fax. +49(0) info@.de

6 Verwendung von Mediabits für die Darstellung technischer Details Zur Differenzierung der Ausgabemöglichkeiten von technischen Details verwenden wir Bitfelder. Ein Bitfeld kann prinzipiell verschiedene Werte annehmen. Dabei ist nicht der Wert eines Bits ausschlaggebend (value), sondern der Status des Bits (0, 1). Hier muss zwingend eine Bitoperation ausgeführt werden. Ein reines Testen auf den Wert reicht unter Umständen nicht aus. z. B.: Soll ein Detail Online und im Printmedium ausgegeben werden, hat das Mediabit den Wert 3 (media_bit = 3). Hier muss bitweise gecheckt werden, wie sich der Wert zusammensetzt. In dem Fall ist das erste und das zweite Mediabit gesetzt, um den Wert 3 zu erhalten ( = 0011). Caching der Daten Die cdxi-daten werden in unserem System fast ausschließlich live generiert. Wenn Sie die Daten anfordern, werden sie zwischengespeichert und liegen ca. 24 Stunden im System, danach werden sie verworfen und es wird bei Anforderung ein neues XML generiert. Struktur der Katalogkategorien auslesen <attributes /> Templatetyp / Kategorietyp (Online, Print etc.) Die Attribute können dazu genutzt werden, um Steuerinformationen über die CDXI zu transportieren. Die Katalogkategorien sind nicht abhängig von den Produktgruppen des -Produkt-Pools. Produkte aus den Katalogkategorien auslesen Der Datensatz beinhaltet die Verknüpfungen zwischen Katalog-Kategorien, Produktzuordnung in den Katalog-Kategorien und der zum Produkt gehörenden ursprünglichen Poolprodukt-ID. Seite 6 von 7 Tel. +49(0) Fax. +49(0) info@.de

7 Ansteuerung von Websites über externe Verlinkung (englisch) (französisch) Für <domain> ist der entsprechende Name der angesteuerten Domain einzutragen. Der Parameter <language> beinhaltet das entsprechende Kürzel für die jeweilige Sprache. Feldergänzungen vom : <description /> <description_short /> <images /> Beschreibung_lang Beschreibung_kurz Kategoriebild(er) Feldergänzung vom <eclass/> Nummer weiterführende Links im Internet zum Thema XML: Seite 7 von 7 Tel. +49(0) Fax. +49(0) info@.de