4 Datenübermittlung

Owned by Daniela Michalak (Deactivated)
Last updated: May 08, 2023 by Digitec Galaxus AG

EINLEITUNG DATENÜBERMITTLUNG

 

Es gibt verschiedene Möglichkeiten Daten auszutauschen welche benötigt werden um Produkte zu erstellen. Diese Seite gibt eine Übersicht über die Möglichkeiten. Galaxus bevorzugt Webservice Anbindungen und den Fileaustausch über einen FTP Server.

Weiter finden Sie hier eine detaillierte Anleitung wie mit dem FTP-Server umzugehen ist.

DATENAUSTAUSCH ÜBER WEBSERVICE

Eine Webservice Anbindung ermöglicht die elektronische Datenlieferung über einen HTTPS Link. Wird ein verschlüsselter HTTPS Link zu Verfügung gestellt, so ist darauf zu achten, dass der Token (Benutzername und Passwort) entweder in der URL angegeben wird oder die Angaben für Digitec Galaxus zur Verfügung stehen. "On-the-fly"-Verarbeitung der Dateien sind nicht zulässig. Die Datei muss aus dem Cache geladen werden können und sollte nicht auf Abruf neu berechnet werden müssen.

 

DATENAUSTAUSCH ÜBER FTP

Durch ein Datenübermittlungstool wird eine Verbindung zu einem FTP-Server hergestellt, um Daten zu transferieren und Zugang zu den Inhalten auf dem Server zu bieten. FileZilla bietet eine freie Server- und Client-Software zur Dateiübertragung mittels sFTP an: FileZilla.

Wir empfehlen die Client-Version zu nutzen.

Ein sFTP-Verzeichnis wird durch Galaxus zur Verfügung gestellt.

Auf der offiziellen Webseite von FileZilla finden Sie ausführliche Dokumentationen zum Programm sowie einen FAQ-Bereich.

 

 

Einrichten eines neuen Servers

  1. FileZilla starten

  2. Die FTP-Verbindungsdaten werden Ihnen bei der Account-Erstellung durch Digitec Galaxus mitgeteilt

    1. Serverlink (sftp://ftp.digitecgalaxus.ch)

    2. Benutzername

    3. Passwort

    4. Port 22 - sofern der Serverlink mit "sftp" beginnt (→ verschlüsseltes FTP-Verzeichnis), andernfalls Port 21

    5. IP 137.116.205.202 (falls benötigt)

3. FTP-Verbindungsdaten in die Suchmaske eingeben

 

Abbildung A: Hauptseite Filezilla

 

  • Zum Abspeichern der Verbindung öffnen Sie den Servermanager (Datei → Servermanager) oder alternativ gehen Sie über den ersten Button links in der Tooltip-Leiste

    1. "Neuer Server" auswählen und den gewünschten Namen eintragen

    2. Im Tab "Allgemein" werden die FTP-Verbindungsdaten eingetragen

    3. Durch Klick auf "Verbinden" oder "OK", wird der Eintrag gespeichert. Im Falle von "Verbinden" werden Sie direkt mit dem neu erstellten Zugang verbunden

 

Abbildung B: Servermanager in Filezilla

MANUELLE ANPASSUNG VON DATENFILES

Hinweise zum File-Upload

  • Es besteht die Möglichkeit durch Drag'n'Drop Files auf den Server zu ziehen oder einen automatisierten System-Upload durchzuführen 

  • Die alten Dateien müssen bei jeder Übermittlung durch die neuen Dateien ersetzt werden

Direkte File-Anpassung auf dem Server im Falle von xlsx-Dateien

  1. Rechtsklick auf das entsprechende File 

  2. Ansehen/bearbeiten anklicken

  3. Änderungen am File vornehmen

  4. Speichern und bestätigen, dass das gewünschte File überschrieben werden soll

Ergänzen/Löschen von Artikeln

  • Entfernen/Löschen: Den/die Artikel vorzugsweise aus allen Files löschen (zumindest Preis-/Bestandesdaten), in dem Sie die gesamte Zeile/Zeilen des Artikels entfernen.
    Eines der Files entspricht dem sortimentsbestimmenden File (Assortment-Datei), welches das aktive Sortiment steuert. Es werden nur Artikel aufgeschaltet, die in der sortimentdefinierenden Datei aufgeführt sind. Artikel, die nicht mehr geliefert werden können, müssen in der nächsten Übermittlung mindestens aus der entsprechenden Datei
    (idealerweise aus allen Files) entfernt werden.

  • Ergänzen/Hinzufügen: Wenn Sie das Sortiment durch zusätzliche/neue Artikel erweitern möchten, müssen die Informationen in allen Files nachgeführt werden.

 

 

Wichtige Hinweise welche bei der Bearbeitung zu beachten sind

Allgemeine Vorgaben zur Datenstruktur

  • Keine Änderung des File-Namens sowie keine Leer- und Sonderzeichen erlaubt

  • Keine Spaltenfixierungen

  • Keine Zeilenumbrüche in der Kopfzeile

  • Keine Änderung der File-Struktur (wie Spaltensortierungen usw.)

  • Keine zusätzlichen Datenblätter einfügen

  • Einheitliche Produktidentifikation durch ProviderKey (= Artikelnummer) in der ersten Spalte konsistent über alle Files

  • EoL-Artikel (= End of Life) aus der Preis- und Bestandesdatenliste entfernen (siehe "Entfernen/Löschen")

Umgang mit CSV-Dateien

  • Sofern die Datenfeeds als CSV-Datei ("Comma-Separated Values") aufbereitet sind, gibt es bei der Aktualisierung einige Punkte zu beachten. Insbesondere dann, wenn die CSV-Dateien nicht mit einem herkömmlichen Texteditor, sondern mit Microsoft Excel bearbeitet werden.

  • Nummerische Werte: Längere Zahlenfolgen wie ProviderKeys oder GTINs werden von Excel teilweise automatisch in ein «Wissenschaftliches Format» umgewandelt (z.B. 1234567890 wird zu 1.24E+08). Enthält eine Zahlenfolge zudem führende Nullen, werden diese ebenfalls entfernt (z.B. 00505 wird zu 505). Vor dem Upload der überarbeiteten Datenfeeds auf den FTP-Server muss daher kontrolliert werden, dass die nummerischen Werte (insbesondere die ProviderKeys und GTINs) korrekt in der CSV-Datei hinterlegt sind.

  • UTF-8-Codierung: Nach dem Bearbeiten der CSV-Datei sollte darauf geachtet werden, dass die UTF-8-Codierung bestätigt wird, damit die Datei beim Speichern nicht beschädigt wird und keine unerwünschten Sonderzeichen angezeigt werden.

  • Formatierungen: Jegliche Formatierungen, die in Excel gemacht werden (z.B. Einfärben von Zellen) gehen verloren, sobald die CSV-Datei geschlossen wird. Auch kann eine CSV-Datei nicht mit mehreren Arbeitsblättern gespeichert werden (es bleibt jeweils nur das beim Speichern aktive Arbeitsblatt erhalten). Allgemein sollte die Filestruktur bei der Überarbeitung der Datenfeeds nicht verändert werden.

  • Ausführliche Hinweise finden Sie nochmals unter dem Bereich Dateiformate