Import von Produkten

Transkript

1 Import von Produkten Grundlegende Beschreibung... 2 Produktseite... 2 Downloadcenter... 2 Qualtitätsgesicherter Ablauf des Produkt Imports... 3 Aufbau des Produkt Imports... 3 Arten des Produkt Imports... 3 Manueller Import... 3 Automatischer Import... 4 Aufbau der Importdaten... 4 Importverzeichnisse... 4 Aufbau der Importdaten... 4 Eintragen der Daten... 4 Typ product... 6 Typ driver... 7 Typ manual... 7 Typ certificate... 7 Typ picture... 8 Namenskonventionen der Dateien... 8 Mindestdaten für eine Produkteingabe... 9 Author State Date Markus Warnking, Draft

2 Grundlegende Beschreibung Produkte im Sinne der Triumph-Adler Website sind Drucksystemen, Kopiersysteme oder weiteres, die die Produktpalette repräsentieren. Mittels der Webseite kann sich der Kunde über diese Produkte informieren, technische Details vergleichen und sich für den Support Treiber, Handbücher etc. downloaden. Relevant sind diese Produkte auf zwei Bereichen der Website, der Produktseite und dem Downloadcenter. Produktseite Auf der Produktseite werden zu jedem Produkt technische Details (Fact Sheet) angezeigt, welche die technischen Details des Produktes weiter beschreiben: Downloadcenter Im Download Center werden zu den jeweiligen Produkten Dokumente und Dateien zum Download angeboten. Dieses ist zurzeit: - Broschüren - Bedienungsanleitungen - Bilder - Zertifikate - Treiber - Utilites

3 Um die händische Eingabe all dieser Daten und die Verwaltung der Dateien zu vereinfachen, wurde ein Mechanismus zum Upload dieser Daten und Dateien eingerichtet. Der Produkt Importer ist ein Programm, welches Daten und Dateien aus einen Verzeichnis liest und diese dann in das CoreMedia System importiert. Qualtitätsgesicherter Ablauf des Produkt Imports Es gibt zwei relevante Systeme, die für den Import Prozess relevant sind. Das Testsystem und das Produktivsystem. Die Vorgehensweise ist dabei, dass Updates zu Produkten oder neue Produkte zuerst auf dem Testsystem importiert werden, damit dann die Vollständigkeit der Daten und Anhänge geprüft werden kann. Wenn die zu importierenden Informationen vollständig und valide sind, kann der Importprozess auf dem Produktivsystem ausgeführt werden. Dort sind sie dann im Livesystem im Internet verfügbar. Aufbau des Produkt Imports Der Produkt Importer unterstützt zwei Arten des Importierens: - Das Aktualisieren von bestehenden Produktdetails und dateien - Dem Hinzufügen von neuen Produkten Ein Entfernen von Produkten im CoreMedia System führt der Produkt Importer nicht aus. Falls Produkte gelöscht werden sollen, müssen diese aus den Import Daten entfernt und händisch über das CoreMedia Studio gelöscht werden. Arten des Produkt Imports Der Import geschieht auf zwei Arten: - Manueller Import - Automatischer Import Voraussetzung für beide Arten des Imports ist ein Verzeichnis, worin die zu importierenden Daten vollständig und im richtigen Schema vorhanden sind. Eine Validierung der Daten vor dem Import erfolgt nicht, eventuelle Falscheingaben können bei der Kontrolle im Testsystem erkannt werden. Manueller Import Der manuelle Import geschieht durch den Aufruf des ImportProgramms über Kommandozeile. Dieser Aufruf kann lokal vom eigenen Rechner erfolgen (falls hier die

4 nötigen Voraussetzungen wie Zugriffsrechte, Umgebungsvariablen etc) oder auch auf dem Testsystem bzw. Produktivsystem. Automatischer Import Auf dem Test- und Produktivsystem gibt es ein Verzeichnis, worin die zu importierenden Daten gepflegt werden. Mittels eines zeitlich gesteuerten Timers wird das Import Programm regelmäßig gestartet, so dass das jeweilige CoreMedia System aktualisisert wird. Beide Arten des Imports können sind sowohl auf dem Test- als auch auf dem Produktivsystem konfiguriert. Dieser automatische Import geschieht einmal pro Tag, jeweils um Uhr. Aufbau der Importdaten Die Basis des Importers sind die Daten und Dateien, welche in das CM System eingefügt werden sollen. Importverzeichnisse Auf den beiden Systemen(Test und Produktion) gibt es dafür folgende Verzeichnis: / /driver /utility /manual /picture /certificate /brochure /product Das Wurzelverzeichnis beinhaltet dabei alle generellen Informationen zu dem Produkt, die anderen Verzeichnisse korrespondieren mit den angezeigten Daten im Downloadcenter. Aufbau der Importdaten Im Wurzelverzeichnis /import werden die Produkte durch die eine Excel Datei master.xlsx beschrieben. Hier werden die Produkte dem Importer bekannt gemacht und auf die entsprechenden Dateien in den Unterordnern verwiesen. Eintragen der Daten Im Root Verzeichnis liegt eine Datei master.xlsx. Hierin werden die zu importierenden Dateien eingetragen.

5 Die Eintrag eines Produktes braucht die folgenden Werte: Bezeichnung Bedeutung des Felder Mögliche Werte Produktbezeichnung Bezeichnung des Produktes Freie Bezeichnung Type Typ der Datei; korrespondiert mit dem Verzeichnis, in dem die Dateien zum abgelegt werden driver utility manual certificate brochure product picture Filename Description Datei, die zu diesen Produkt importiert und zugeordnet wird Hierbei ist der volle Dateiname und Endung einzugeben; auf Groß- und Kleinschreibung ist zu achten Die Komination Type + Filename muss dabei den Dateien im Verzeichniss entsprechen Einige Produkte haben Excel Dateien, die die einzelnen Eigenschaften beschreiben, zum Beispiel die Produktdaten eines Treibers, o.ä. Diese Beschreibung wird der Datei und dem Produkt aus der gleichen Excel Zeile zugeordnet. Der verwendete Dateiname muss dabei der gleiche sein wie in Filename, allerdings mit der Endung xlsx Die Angabe der Description ist optional Dateiname der im Verzeichniss abgelegten Datei Gleiche Wert wie in Filename, allerdings als xlsx. Nur bei Type: driver utility

6 Typ product Für die Beschreibung eines Produktes muss eine Excel Datei im Verzeichnis /product vorhanden sein. Diese wird in der master.xls mit dem Typ product in das Feld Filename eingetragen. Die Beschreibung des Produktes erfolgt innerhalb dieses Excels, deswegen muss auch das vorhanden Format dieser Datei beibehalten werden. Es sollten nur die Werte in der Spalte C angepasst werden, ansonsten kann es zu Problemen beim Import des Produktes kommen. Für jedes zu importierende Produkt muss ein Eintrag vom Typ product vorhanden sein. Es darf für jedes zu importierende maximal ein Eintrag vom Typ product vorhanden sein. Das hier in Zeile 1 genannte Produkt ist letzendlich der Name des Produktes, der im CM als Produktname angezeigt wird.

7 Typ driver Zum Typ driver gehören immer die eigentliche Treiberdatei, die in der Spalte Filename angegeben werden soll, und eine Beschreibende Excel, die zusätzliche Informationen enthält. Der Dateiname dieser beiden Dateien muss bis auf die Endung identisch sein. Typ manual Das Handbuch zur Datei; üblicherweise ein PDF Typ certificate Zertifikate zum Produkt; üblicherweise ein PDF

8 Typ picture Bilder zum Produkte; üblicherweise JPEGs Format. Namenskonventionen der Dateien Um die Dateien automatisch verschiedenen Werten wie Sprachen zuzuordnen, gibt es bei einigen Typen ein Namensschema, damit diese in der Weboberfläche automatisch gefiltert und entsprechend angezeigt werden können. Konvention Betrifft Dateien der Typen Mögliche Werte XX_ am Dateianfang gibt die Sprache der Datei an Beispiel: DE_BAM-KI-TA_ta_P-5320D_P- 5500D_P3755F.pdf ZZ_cCD-cLP-MacOSx dmg driver certificate brochure manual picture utility DE EN CZ... (entsprechend ISO Konvention) ZZ : entspricht allen Sprachen XX nach der Sprache gibt die TA produkt Kategorie an. DE_BAM-KI-TA_ta_P-5320D_P- 5500D_P3755F.pdf driver certificate brochure manual picture utility TA Kategorien

9 ZZ_cCD-cLP-MacOSx dmg Mindestdaten für eine Produkteingabe Für die Neuanlage eines Produktes muss mindestens ein Eintrag in der master.xlsx vom Typ product sein (aber auch nicht mehr). Die entsprechende Excel Datei muss dabei zumindest aus den gelb markierten Feldern bestehen.