currency.dat enthält die Umrechnungskurse, mit denen der Online-Servicebereich der WEBSALE AG Beträge in unterschiedlichen Währungen zusammenfasst. Gebraucht wird das vor allem in der Umsatzstatistik, wenn ein Shop in mehreren Währungen verkauft und die Auswertung trotzdem eine einzige Summe zeigen soll.
Pflegen Sie die Datei nicht im Dateisystem, sondern im Online-Servicebereich über den Dienst “Statistik (Verkäufe)”. Dort bearbeiten Sie dieselben Werte in einer Eingabemaske, und der Dienst prüft Ihre Eingaben sofort.
Referenz: shop.config, Preise, Steuern und Währung · Grundlagen: Grundlagen zu Konfigurationen
Aufbau
Die Datei liegt im Konfigurationsverzeichnis des Shops und gilt für den ganzen Shop, also nicht getrennt nach Subshop oder Sprache. Sie ist tabulatorgetrennt aufgebaut. Die erste Zeile enthält die Spaltennamen, ab der zweiten Zeile folgt je Währung eine Zeile.
Die drei Spalten werden über ihre Namen in der Kopfzeile gefunden, nicht über ihre Position. Die Reihenfolge der Spalten ist deshalb frei, die Schreibweise der Spaltennamen dagegen nicht. Fehlt eine der drei Spalten, lässt sich die Datei nicht laden.
Was beim Laden geprüft wird
Die folgenden Regeln entscheiden darüber, ob der Online-Servicebereich Ihre Datei annimmt. Jede einzelne führt bei Verletzung dazu, dass die gesamte Datei abgelehnt wird, nicht nur die betroffene Zeile. Der Kurs der Basiswährung muss genau1 sein. Das ist der häufigste Stolperstein. Die Basiswährung rechnet sich auf sich selbst um, jeder andere Wert gilt als Konfigurationsfehler.
Es muss genau eine Basiswährung geben. Fehlt die Kennzeichnung x in allen Zeilen, wird die Datei abgelehnt. Tragen mehrere Zeilen ein x, gewinnt die letzte davon in der Datei. Verlassen Sie sich nicht darauf, sondern kennzeichnen Sie genau eine Zeile.
Im Umrechnungsfaktor sind nur Ziffern und der Punkt zulässig. Ein Komma als Dezimaltrennzeichen, ein Vorzeichen oder ein Leerzeichen führt zur Fehlermeldung “Ungültiger Umrechnungskurs”. Schreiben Sie 1.0875, nicht 1,0875.
Der Faktor 0 ist ungültig. Er würde eine Division durch null bedeuten und wird wie ein Syntaxfehler behandelt.
Als Kennzeichen der Basiswährung wertet der Online-Servicebereich ausschließlich x oder X aus. Der Bindestrich in allen übrigen Zeilen ist Konvention und erleichtert das Lesen, geprüft wird er nicht. Eine leere Zelle hätte dieselbe Wirkung.
In der Bearbeitungsmaske
Beim ersten Aufruf des Dienstes legt der Online-Servicebereich die Datei an, falls im Shopverzeichnis noch keine existiert. Als Vorlage dient dabei die Standarddatei der WEBSALE AG. Sie beginnen also nie mit einer leeren Liste. Die Maske zeigt die Basiswährung getrennt oberhalb der Liste an. In der Liste selbst stehen nur die übrigen Währungen mit ihrem Kurs, und darunter hängen immer drei leere Zeilen für neue Währungen. Währungsnamen werden beim Laden in Großbuchstaben umgewandelt. Ob Sieeur oder EUR eintragen, spielt deshalb keine Rolle.