FAQ/Export/Content, Produktdaten

Aus ITscope GmbH - Wissensbasis

1 Wieso werden keine Samsung- und Philips-Bilder exportiert?

Die Bilder von Samsung und Philips sind derzeit bei den meisten Kunden aus Gründen der Abmahnsicherheit deaktiviert. Auf Anfrage schalten wir sie Ihnen frei. Bitte beachten Sie, daß Sie für die Nutzung der Bilder Samsung- bzw. Philips-Partner sein sollten oder ganz allgemein eine Genehmigung zur Nutzung der Bilder vorliegen haben sollten.

2 Wie kann ich Lieferantenbilder exportieren?

Hier finden Sie einige Möglichkeiten, neben den CNET und DCI-Bildern auch Lieferantenbilder zu exportieren, um sie beispielsweise lokal zu speichern:

Eindeutiges Lieferantenbild für jeden Artikel:

Xpath.eval("its:bestImage('', 1, 'medium', 0, 0, 0, 1)/bestImageLink/content")

Artikel eines speziellen Lieferanten (z.B. Ingram = 14):

Xpath.eval("medium[preisliste/id=14 and typ='Bild']/link")

Die IDs finden Sie unter Lieferanten.

Alle Bilder der Lieferanten in einer Extra-Datei:

Im Formatmodellierer links bei den Exportdateien eine Datei mit Datensatztyp "Bild/Datenblatt" hinzufügen und dort einige vordefinierte Felder hinzufügen.

3 Wie rufe ich Datenblätter im PDF-Format ab?

Sie müssen den Anfrageparameter pdf auf true setzen. Alternativ können Sie das vordefinierte Feld cont_pdfDatasheet verwenden.

Beispiel:

"http://www.web-datenblatt.de/xsltService?method=getDataSheet&iwsKey=" 
+ param["iwsKey"] + "&productId=" + Xpath.eval("uid") + 
"&customSheet=true&pdf=true&returnAsFile=false"

Diese Felddefinition exportiert Ihnen für jedes Produkt den Link zu einem automatisch in PDF konvertierten Datenblatt.

Sie können die abgerufenen Datenblätter für Angebote (z.B. per Email verschickt) oder die Datenblattlinks in Warenwirtschaften, Webshops etc. einbauen.

Beachten Sie bitte die rechtlichen Hinweise zur Content-Verwendung.

4 Wichtige aktuelle Hinweise für Webshop-Betreiber

Als Webshop-Betreiber sollten Sie derzeit keine Samsung-Datenblätter mit Bildern anzeigen lassen, insbesondere wenn Sie günstige Preise anbieten. Allgemein kann DCI keine Gewähr für die Bilder übernehmen. Lesen Sie bitte die entsprechenden Abschnitte in unseren AGB dazu.

5 Wie exportiere ich Produktbezeichner? Wie kann ich sie für Shops einheitlicher machen?

In der ITscope-Datenbank sind Produktbezeichner getrennt in 3 Felder: manufacturerName, productName und shortInfo.

Je nachdem welche Ausführlichkeit der Daten Sie wünschen, müssen Sie diese Felder beim Export wieder zusammenziehen. Um dabei unschöne Ergebnisse mit "null" zu vermeiden, sollten Sie als Methode Xpath.evalToString verwenden. Ein Beispiel, wie man lange Produktbezeichner erhält:

Xpath.cleanText(Xpath.eval("productName") 
+ " - " + Xpath.evalToString("shortInfo"));

6 Wie kann ich die vorgegebenen Produktbezeichner mit lieferantenspezifischen überschreiben?

Derzeit können nur über Umwege Produktbezeichner der Lieferanten herangezogen werden. Für das nächste Update ist dies aber im Rahmen der Überarbeitung der Contentsystematik angedacht: Dann können Sie die Reihenfolge bestimmen, wie Produktbezeichner exportiert werden: z.B. zuerst Ingram Micro-Bezeichner; wenn diese nicht vorhanden sind, ITscope-Bezeichner usw..

Dieselbe Vorgehensweise wird es dann auch für die Contentfelder Beschreibung, Bilder und Datenblätter geben.

7 Wie formatiere ich Bezeichnungen und Beschreibungen und Felder aller Art?

Dafür gibt es derzeit mehrere Funktionen, die aber noch weiter ausgebaut werden:

1) Xpath.cleanText() entfernt Leer- und Sonderzeichen am Wortanfang und Wortende
2) replace() ersetzt einmalig eine Zeichenkette
3) substr() gibt Teile von Strings zurück
4) Weitere Funktionen siehe Expression-Editor im MarketViewer, unter Javascript ? String

Sie müssen auf den Rückgabewert des entsprechenden Feldes achten, bevor Sie die Zeichenkettenfunktionen anwenden.

Das Feld productName enthält beispielsweise einen String und kann direkt verarbeitet werden. Andere Datentypen müssen erst mittels toString() in einen String konvertiert werden, um weitere Funktionen anzuwenden.
Beispiel der Umformatierung von Preisen:

Xpath.eval("its:priceCalc($pcId, $suppliers)/calcPrice").toString().replace(".", ",")

Hinweis: Um Null-Checks müssen Sie sich keine Gedanken machen, das wird automatisch abgefangen und das Feld leer gelassen.

8 Wie exportiere ich Produktbeschreibungen?

Im allgemeinen sollten Sie dafür die Datenblattlinks einbetten. Sie enthalten die ausführlichsten Informationen auf strukturierte Art und Weise und können nahezu überall eingebunden werden.

Wenn Sie dennoch eine Beschreibung als Text benötigen: Es steht Ihnen per Feld productDescription der längste Beschreibungstext eines der ausgewählten Lieferanten zur Verfügung. In Zukunft soll genauer bestimmt werden können, welcher Beschreibungstext exportiert werden kann. Gegen geringen Aufpreis wird dann auch die DCI-Beschreibung separat vom Datenblatt mit exportiert werden können. Auch eine generierte ITscope-Beschreibung aus den technischen Merkmalen ist denkbar.

9 Welche Typen von Bildern können exportiert werden und wie dürfen sie verwendet werden?

CNET/DCI-Bilder

Sie können Thumbnails (100x75), mittelgroße (200x150) und große Bilder exportieren (500x500). Die entsprechenden Felder heißen: cnetImageLinkThumb, cnetImageLink und dciImageLinkBig. Die großen Bilder sind nicht für alle Produkte vorhanden und erfordern den Abschluß eines gesonderten Vertrags mit DCI. Die zwei anderen Größen sind nur bei DCI-qualifizierten Produkten vorhanden. Sie dürfen die Bilderlinks auch nur als Links speichern und die Bilder nicht lokal zur weiteren Verwendung speichern. Das heißt konkret, daß Ihre Warenwirtschaft und Ihr Onlineshop für die Verwendung von Bilderlinks angepaßt werden muß.

Lieferantenbilder

Sie können in einer gesonderten Datei alle Bilderlinks auch von den Lieferanten exportieren, die Sie eingestellt haben. Dazu müssen Sie unter "Datensatz modellieren" links ein neues Exportobjekt vom Typ "Bild/Datenblatt" anlegen. Alle Möglichkeiten zum Export der Lieferantenbilder.

Automatische Bilderauswahl

Über die Methode its:bestImage können die Bilder der Reihe nach ausgewählt werden, zuerst CNET, dann DCI, dann Lieferantenbilder. Das zugehörige vordefinierte Feld heißt cont_imageLinkBestContent.

10 Welche Datenblätter kann ich exportieren?

Es gibt zwei Datenblattservices, die sich durch zwei vordefinierte Felder in die Exporte einbinden lassen:

1) das DCI-Webdatenblatt, das nur für DCI-qualifizierte Produkte vorhanden ist, das entsprechende Feld mit dem Link heißt cont_datasheetLinkDci

2) das ITscope-Datenblatt (cont_datasheetLinkItscope), das für jedes andere Produkt generiert werden kann aus Lieferantendaten und von ITscope erstellten technischen Merkmalen. Bei DCI-qualifizierten Produkten gibt der ITscope-Service das DCI-Webdatenblatt zurück. Der Service kann also anstelle des DCI-Datenblattservice verwendet werden, um mehr Produkte abzudecken.

Aufbau des Datenblattlinks (technische Dokumentation).

Verwendung von ITscope-Datenblättern in Webshops: Da die Datenblätter aus Lieferantendaten inkl. Bildern generiert werden, müssen Sie bei externer Verwendung die Auswahl der Lieferantendaten einschränken auf Ihre eigenen Lieferanten. Dafür müssen Sie im Datenblattlink eine dataSourceId angeben, das ein Profil oder Portfolio referenziert. Davon wird dann die Lieferanteneinstellung übernommen zur Einschränkung der Datenquellen für das Datenblatt.

Beispiel: Portfolio mit Lieferanten b.com und Devil wird im Datenblattlink angegeben: Das Datenblatt wird dann nur aus Daten und Bildern von b.com und Devil generiert.

Eine einheitliche und ausführliche Qualität der Daten liefert nur das DCI-Webdatenblatt, das aber wiederum nicht für alle Produkte vorhanden ist. Wenn Sie viele Produkte in Ihrem Sortiment haben, die nicht von DCI qualifiziert sind, sollten Sie den ITscope Datenblattservice nutzen.

11 Darf ich die Datenblätter und Bilder lokal speichern?

Bei DCI- und ITscope-Bildern und Datenblättern: Nein, diese dürfen nur verlinkt in Shops oder Warenwirtschaften eingebunden werden, es sei denn, es liegt ein entsprechender Contentvertrag mit DCI vor.

Bei allen anderen Bildern der Lieferanten: Hier kommt es auf die ecommerce-Richtlinien des jeweiligen Distributors an, ob eine lokale Speicherung erlaubt ist oder nicht.

12 Wie binde ich Datenblätter und Bilder in meinen Shop/Warenwirtschaft/xyz ein?

Bilder: Direkt verlinken. Eine Beispiel-Vorlage für xt:commerce in Kombination mit einem Bilderskript können Sie verwenden.

Datenblätter: Direkt verlinkt per iframe oder per serverseitigem Abruf und Einbindung in das generierte HTML (z.B. [1]). Sie können das Datenblatt im Design anpassen lassen, so daß es besser auf Ihre Seite paßt. Innerhalb der Warenwirtschaft kann der Link meist direkt hinterlegt werden.

Wenden Sie sich bitte an unsere Technologie-Partner, um mehr zu erfahren.

13 Wie ändere ich die Datenblätter meinen Vorstellungen entsprechend ab? Kann ITscope das übernehmen?

Das Datenblattdesign kann für DCI- und ITscope-Datenblätter einheitlich abgeändert werden und beispielsweise an einen Shop angepaßt werden. Beispiele und Preise siehe Anpassungsaufträge/Datenblattanpassung. Dabei bleibt die Struktur des Datenblatts weitestgehend erhalten, folgendes kann modifiziert werden:

1) Header (kann auch komplett verschwinden) 2) Farben und Balkenformen 3) Maße (Breite des Templates, Breite der Spalten etc.)

14 Was bedeuten die Felder im xt:commerce-Export?

Siehe Spaltendokumentation.

15 Wie exportiere ich Zubehörreferenzen?

Allgemein: Im Datenprofil den Parameter "Zubehör hinzufügen" auswählen. Vorsicht: Das geht nicht bei allen Profilen. Für Produktportfolios: Zusätzlich muß hier noch im Portfolio der Parameter "Zubehör exportieren" asugewählt sein.

Wichtig: Die Zubehöreinstellung im Datenprofil berücksichtigt nur Produkte, die auch im Exportsortiment vorhanden sind. Sie müssen also sicherstellen, daß die zu exportierenden Zubehörprodukte zum Sortiment hinzugefügt werden. Im allgemeinen erreichen Sie dies dadurch, daß Sie beim Erstellen eines Produktportfolio auch die entsprechenden Zubehörkategorien auswählen oder, um ganz sicherzugehen, den Parameter "Zubehör exportieren" im Portfolio aktivieren. Bitte beachten Sie aber, daß Sie bei letzterer Einstellung keine Kontrolle mehr darüber haben, welche Kategorien genau exportiert werden: Beispiel: Sie wählen in einem Produktportfolio nur die Drucker-Kategorien aus und aktivieren "Zubehör exportieren". Dadurch enthält das Produktergebnis zusätzlich zu den Druckern auch alle Zubehörprodukte aus allen möglichen anderen Kategorien! Wenn Sie für Drucker nur Tinte/Toner exportieren möchten, müssen Sie "Zubehör exportieren" deaktiviert lassen und die Kategorien manuell auswählen.