Sie sind auf Seite 1von 12

INFOnline

Manual

Code-Export und -Import

INFOnline GmbH
Brühler Straße 9
53119 Bonn

Tel.: +49 (0) 228 / 410 29 - 0


Fax: +49 (0) 228 / 410 29 - 66

www.INFOnline.de
info@INFOnline.de
Inhalt

1 Über dieses Dokument ......................................................................................... 1

2 Konfiguration per Code-Export und -Import im Modul Code-Management..... 2


2.1 Code-Export und Code-Import im KAT 2.0....................................................... 2
2.2 Der Inhalt der CSV-Datei.................................................................................. 2
2.3 Der Code-Export .............................................................................................. 4
2.4 Der Code-Import............................................................................................... 4
2.5 Formatbeschreibung ........................................................................................ 4
2.6 Syntaxprüfung .................................................................................................. 4

3 Die Bearbeitung der CSV-Datei ........................................................................... 8


3.1 Codezuordnungen erstellen ............................................................................. 8
3.2 Bestehende Codezuordnungen ändern............................................................ 8
3.3 Neue Codes anlegen........................................................................................ 8
3.4 Codezuordnungen aufheben ............................................................................ 9
3.5 Codebeschreibungen erstellen, ändern und löschen ....................................... 9
3.6 Abspeichern der CSV-Datei ............................................................................. 9

4 Kontakt ................................................................................................................ 10
1 Über dieses Dokument
Dieses Manual beschreibt die Handhabung des Code-Imports und –Exports im Tool Code-
Management des INFOnline Kunden Centers.

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 1


2 Konfiguration per Code-Export und -Import im Modul
Code-Management

2.1 Code-Export und Code-Import im KAT 2.0


Im Bereich Code-Management KAT 2.0 ist es möglich, Codes und deren Zuweisung zu verwalten
sowie die Codezuordnung zu bearbeiten. Neben der Bearbeitung innerhalb des Kunden Centers
besteht auch die Möglichkeit, die Codezuordnung als Exceldatei im CSV-Format zu exportieren
(Code-Export). Nach dem Export kann die Datei offline bearbeitet werden und anschließend
wieder in das System importiert werden. Dabei werden die zu importierenden Informationen
validiert (Code-Import). Diese Funktion ist für alle Angebote verfügbar, die nach dem
Kategoriensystem 2.0 zugeordnet werden müssen.

Bitte beachten Sie, dass der Code-Export sowie Code-Import nur dann funktionsfähig sind,
wenn weniger als 10.000 Codes im Kunden Center angezeigt werden. Sollten mehr Codes
vorhanden sein, so können der Code-Export sowie Code-Import nicht gewährleistet werden.
Im Fall, dass Sie im Kunden Center zuviele Codes im Kunden Center nutzen, wenden Sie sich
bitte an den Support (support@INFOnline.de), damit die Codes aus dem System gelöscht
werden. Bitte beachten Sie, dass die Löschung ein kostenpflichtiger Service ist. Weitere
Informationen hierzu erhalten Sie ebenfalls vom Support.

2.2 Der Inhalt der CSV-Datei


Die CSV-Datei (Code-Export) ist wie folgt gegliedert:
 Die ersten Zeilen der CSV-Datei beinhalten die Kategorien.
 Im Anschluss daran werden – insofern vorhanden – die nicht zugeordneten Codes
aufgelistet.
Die Spalten der CSV-Datei sind wie folgt aufgeteilt und entsprechen den Inhalten, die im
Code-Management KAT 2.0 des Kunden Centers sichtbar sind.

Spalte A Code
Spalte B Code Beschreibung
Spalte C Sprache
Spalte D Format
Spalte E Erzeuger

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 2


Spalte F Homepage
Spalte G Auslieferung
Spalte H App
Spalte I Paid Content / Paid Service
Spalte J Inhalt

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 3


2.3 Der Code-Export
Im Code-Management besteht die Möglichkeit, die Codezuordnungen per Mausklick als CSV-Datei
herunter zu laden und diese anschließend zu bearbeiten. Es können Codezuordnungen erstellt,
geändert und aufgehoben werden. Außerdem können Beschreibungen von Codes erstellt und
geändert werden. Zudem können auch neue Codes für das Angebot erstellt werden. Gelöschte
und blockierte Codes sind nicht im Code-Export enthalten.

2.4 Der Code-Import


Nach dem Bearbeiten kann die aktualisierte Codezuordnung wieder in das System hochgeladen
werden. Den Code-Import erreichen Sie über das Code-Management KAT 2.0 im Kunden Center.
Nach dem Aufruf des Code-Imports müssen Sie sich in das Tool mithilfe der Logininformationen
des Kunden Centers einloggen (analog z.B. zum Analysetool IDAS).
Der Import erfolgt in drei Schritten, die im Tool durchnummeriert sind:
 Zuerst wählen Sie in einem ersten Schritt im Dropdown-Menü ein Angebot aus.
 Im zweiten Schritt wählen Sie die von Ihnen bearbeiteten und zu importierenden Daten aus.
Mit der Auswahl der Datei erfolgt in diesem Schritt die Validierung der Inhalte dieser Datei.
Nach der Validierung erhalten Sie das Ergebnis der Überprüfung. Sie können dabei
entscheiden, ob Sie die validierten Zeilen importieren möchten. Außerdem erhalten Sie
über eine Logdatei Einsicht in gefundene Fehler, die Sie entsprechend in der
ursprünglichen Import-Datei korrigieren müssen, um die Zeilen ins System hochladen zu
können.
 Im dritten Schritt erfolgt dann der Import der validierten und für korrekt befundenen Zeilen
ins Code-Management KAT 2.0.

2.5 Formatbeschreibung
Die heruntergeladene CSV-Datei hat folgende Formateigenschaften:
 Trennzeichen ist das Semikolon
 Jede Zeile endet mit einem DOS/Windows-Zeilenumbruch
 Codierung ist UTF8 ohne BOM / Signatur

2.6 Syntaxprüfung
 Es werden generell nur ".csv"-Dateien akzeptiert. Beachten Sie bitte, dass eine
Codebegrenzung von maximal 3.000 Codes besteht. Weitere Zeilen werden ignoriert.

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 4


Wollen Sie mehr als 3.000 Codes nutzen, müssen Sie dies im Vorfeld (!) zwingend mit dem
Customer Service-Team der INFOnline abstimmen.
 Die CSV-Datei wird vor dem Import detailliert überprüft.
 In der Logdatei werden alle gefundenen Fehler gespeichert.

ACHTUNG: Die CSV muss im CSV-Format ( CSV, Trennzeichen getrennt) mit dem Zeichensatz
UTF8 ohne BOM / Signatur eingespielt werden. Das Einspielen anderer CSV-Formate (Macintosh,
MS-DOS-CSV, UTF8 mit BOM) werden nicht importiert. Sie erhalten in der Logdatei eine
entsprechende Fehlermeldung.

In folgenden Fällen wird der Import einer Zeile der Datei abgelehnt und eine Fehlermeldung
innerhalb der Logdatei angelegt:

1. Wenn innerhalb der Kategorien fehlerhafte Werte stehen. Die korrekten Werte sind:

 Sprache:
 Deutsch
 Andere Sprache, Inhalt prüfbar
 Andere Sprache, Inhalt nicht prüfbar
 Format:
 Bild / Text
 Audio Stream
 Video Stream
 Andere dynamische Formate

 Erzeuger:
 Redaktion
 User
 Unbekannt

 Homepage:
 Homepage des Angebots
 Keine Homepage
 Homepage der Fremddomains bei Multi-Angeboten

 Auslieferung:
 Online
 Mobile
 Connected TV

 App:
 App

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 5


 Keine App

 Paid Content:
 Paid
 nicht zugeordnet
 Inhalt:
 Social Networking - Privat
 Social Networking - Business
 Partnersuche / Dating
 Newsletter
 E-Mail / SMS / E-Cards
 Messenger / Chat
 Sonstiges (Bereich Networking / Kommunikation)
 Nachrichten
 Sport
 Entertainment / Boulevard / Stars / Film / Musik
 Fashion / Beauty
 Familie / Kinder / Lebenshilfe
 Liebe / Psychologie / Beziehungen
 Fahrzeuge / Verkehr / Mobilität
 Reise / Touristik
 Computer
 Consumer Electronics
 Telekommunikation / Internetdienste
 Spiele
 Wohnen / Immobilien / Garten / Haushalt
 Wirtschaft / Finanzen / Job / Karriere
 Gesundheit
 Essen / Trinken
 Kunst / Kultur / Literatur
 Erotik
 Wissenschaft / Bildung / Natur / Umwelt
 Angebotsinformation
 Vermischtes (multithematisch)
 Sonstiges (monothematisch)
 Allgemeine Games-Seite
 Casual Games
 Core Games
 Sonstiges (Bereich Spiele)
 Suchmaschinen
 Verzeichnisse / Auskunftsdienste
 Sonstiges (Bereich Suchmaschinen / Verzeichnisse)
 Onlineshops / Shopping Mall / Auktionen / B2B Marktplätze

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 6


 Immobilien Rubrikenmärkte / Kleinanzeigen
 Jobs Rubrikenmärkte / Kleinanzeigen
 Fahrzeuge Rubrikenmärkte / Kleinanzeigen
 Sonstiges Rubrikenmärkte / Kleinanzeigen
 Sonstiges (Bereich E-Commerce)

2. Wenn der Code nicht nach Vorgabe benannt ist.

 Die Vorgabe lautet: Der Code muss alphanumerisch sein (a-z, A-Z, 0-9) und darf (nur!)
folgende Sonderzeichen enthalten: Komma ","; Bindestrich "-"; Unterstrich "_"; Slash "/“.

3. Sonderfall hybride Codes:

 Wenn im ausgewählten Digital-Angebot keine Codes mit hybriden Präfix verwendet werden
dürfen, darf das Präfix ___hyb___ nicht verwendet werden.
 Darf im Digital-Angebot das hybride Präfix verwendet werden, kann es sein, dass die
Codes nicht verändert werden dürfen. Sollte dieser Fehler auftreten, wenden Sie sich bitte
an den technischen Support der INFOnline.
 Hybride Codes dürfen lediglich geändert, aber nicht angelegt werden!

4. Ein Fehler in einer der Spalten schließt die gesamte Zeile vom Upload aus, da es nur zwei
Zustände von Codes gibt:

 „nicht zugeordnet“ (alle 8 Merkmale ohne Zuordnung)


 oder
 „komplett zugeordnet“ (alle 8 Merkmale mit einer Zuordnung)

5. Sollte ein Code eine Länge von mehr als 255 Zeichen haben, wird dieser beim Import an der
254. Stelle abgeschnitten. An der 255. Stelle wird ein „+“ als letztes Zeichen eingefügt.

6. Fehler werden in eine Fehler-Log-Datei geschrieben. Hierbei werden die folgenden


Informationen angegeben:

 Die Zeilennummer der Datei


 Der Name des Codes, in dem der Fehler identifiziert wurde
 Die Spaltennummer, in der der Fehler identifiziert wurde
 Der Name der Spalte, in der der Fehler identifiziert wurde.

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 7


3 Die Bearbeitung der CSV-Datei
Über den Code-Export und Code-Import ist es möglich, Codezuordnungen zu erstellen und
Codezuordnungen aufzuheben sowie neue Codes anzulegen. Eine potenzielle Einsatzmöglichkeit
ist die Übertragung von KAT 2.0-Codezuordnungen eines (z.B. mobilen) Digital-Angebots auf ein
anderes Digital-Angebot (z.B. das entsprechende stationäre Angebot).
Zu beachten wäre im dargestellten Beispiel, dass dabei die Auslieferung entsprechend verändert
werden müsste.
Es ist nicht möglich, Codes über den Code-Export bzw. den Code-Import zu löschen oder zu
blockieren!
Hingegen ist es möglich, im System blockierte oder gelöschte Codes durch den Import zu
reaktivieren.
Generell ist Folgendes zu beachten:
 Pro Zeile darf nur 1 Code angegeben werden.
 Sämtliche Codes, die nicht in der Datei enthalten sind, werden nicht bearbeitet und werden
im Code-Management nicht verändert!

3.1 Codezuordnungen erstellen


Um einen bestehenden Code nach KAT 2.0 zuzuordnen, muss der Code in eine leere Zeile (Spalte
A) eingetragen werden. Liegt bereits ein Code mit der gleichen KAT 2.0-Zuordnung vor, kann
diese Zeile kopiert werden. Der Code in Spalte A muss dann durch den neu zuzuordnenden Code
ersetzt werden.

3.2 Bestehende Codezuordnungen ändern


Um eine bestehende Codezuordnung zu ändern, müssen beim entsprechenden Code in einer oder
mehreren der Kategorienspalten die Merkmale entsprechend den Vorgaben verändert werden.

3.3 Neue Codes anlegen


Es ist möglich, über den Code-Export / Import auch neue, d.h. dem System bislang nicht bekannte
Codes in das System einzupflegen.
Um einen neuen Code MIT Zuordnung in das System einzupflegen, muss der neue Code in Spalte
A eingetragen werden. Alle acht Kategorienspaltenzellen müssen nach den bestehenden
Vorgaben (siehe Punkt 1.5) ausgefüllt werden!
Um einen neuen Code OHNE Zuordnung in das System einzupflegen, muss der neue Code
lediglich in Spalte A eingetragen werden. Alle acht Kategorienspaltenzellen müssen leer belassen
werden!

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 8


Eine lediglich partielle Codezuordnung ist technisch unterbunden und führt zu einer
Fehlermeldung.

3.4 Codezuordnungen aufheben


Um eine bestehende Codezuordnung aufzuheben, müssen beim entsprechenden Code alle acht
Kategorienspaltenzellen geleert werden.

3.5 Codebeschreibungen erstellen, ändern und löschen


Um eine Beschreibung zu einem Code zu erstellen, muss die Beschreibung des Codes in der
entsprechenden Spaltenzelle „Code Beschreibung“ (Spalte B) eingegeben werden.
Um eine Beschreibung zu einem Code zu ändern, überschreiben Sie die entsprechende
Spaltenzelle „Code Beschreibung“ (Spalte B).
Ein leerer Eintrag in einer Spaltenzelle „Code Beschreibung“ (Spalte B) löscht - sofern vorhanden
– eine bestehende Codebeschreibung.

3.6 Abspeichern der CSV-Datei


Die CSV-Datei muss mit dem Zeichensatz (der Codierung) UTF8 ohne BOM (UTF8 ohne Signatur)
gespeichert werden, da die Datei ansonsten nicht im Code-Import eingeladen wird.
Wir empfehlen Ihnen, die Bearbeitung der exportierten CSV beispielsweise mit einem Text-Editor
Ihrer Wahl vorzunehmen. Es ist wichtig, dass Ihre CSV stets ohne Signatur (BOM) gespeichert
wird.
Excel verwendet beim standardmäßigen Speichern den Zeichensatz ANSI. Die Umstellung auf
UTF8 ist keine Lösung, da unter Windows der Zeichensatz UTF8 mit BOM / Signatur verwendet
wird.
Falls Sie Ihre Bearbeitung in Microsoft Excel durchführen möchten, ist es zwingend notwendig,
dass keine weiteren Tabellenblätter oder ähnliches hinzugefügt werden.
HINWEIS: Nutzen Sie bitte stets die Funktion „Speichern“ und bitte NICHT die Funktion
„Speichern unter“. Dadurch vermeiden Sie, dass Ihre CSV eine BOM-Signatur erhält.

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 9


4 Kontakt
Das Customer Service-Team ist werktags von 9 bis 18 Uhr erreichbar via
Telefon: 0228 / 410 29 – 77
E-Mail für organisatorische Anfragen: service@INFOnline.de
E-Mail für technische Anfragen: support@INFOnline.de

INFOnline Manual Code-Export und -Import Version 2.2 14.08.2018 Seite 10