...
Transfer to third parties only with written permission of WEBSALE AG.
Produktdatenexport
...
Aktivierung und Name des Templates
Der Export von Produktdaten unter Benutzung eines Templates wird aktiviert, in dem die zugehörige Template-Datei in das Ausgabeverzeichnis der Exportdatei kopiert wird. Der Name dieser Datei ist fest vorgegeben und lautet "export-template.txt".
In diesem Verzeichnis wird weiterhin auch eine Datei mit Namen "lastexport.ini" angelegt. Diese Datei enthält den Zeitstempel und eine laufende Nummer des letzten Exports. Diese Daten werden für eine eventuelle Bildübertragung benötigt, sowie zur Bildung einer Versionsnummer für die Datei, die für manche Dateiformate benötigt wird.
Unterstützte Tags
| Scroll content block | ||||||
|---|---|---|---|---|---|---|
"EXP-" TagsTags mit dem Präfix “EXP-“ beziehen sich auf shopweit gültige Daten, die nicht in der shop.config oder anderen „normalen“ Konfigurationsdateien enthalten sind.
|
...
Tag | Beschreibung | Beispiel |
|---|---|---|
DC-FPX | Das Einzel-Tag gibt den aktuellen Inhalt des Arguments aus. Das Bereichs-Tag prüft, ob der freie Parameter gesetzt ist. |
|
DC-FPX_set(value) | Das Einzel-Tag befüllt das Argument, das mit dem Parameter übergeben wird. | Template: Ausgabe: |
DC-FPX_reset | Das Einzel-Tag löscht den Inhalt des freien Parameters. | Template: Ausgabe: |
DC-FPX_append | Das Einzel-Tag erweitert den Inhalt des freien Parameters. | Template: Ausgabe: |
DC-FPX_length | Das Einzel-Tag gibt die Anzahl an Zeichen aus. | Template: Ausgabe: |
DC-FPX_HexDecode | Das Einzel-Tag gibt den Inhalt hex dekodiert aus. | Template: Ausgabe: |
DC-FPX_HexEncode | Das Einzel-Tag gibt den Inhalt hex enkodiert aus. | Template: Ausgabe: |
DC-FPX_ENCXML | Das Einzel-Tag gibt den Inhalt XML enkodiert aus. | |
DC-FPX_replace(find,replace) | Das Einzel-Tag durchsucht den Inhalt nach dem Parameter1 Argument1 (find) und ersetzt ihn durch Parameter2 Argument2 (replace). | Template: Ausgabe: |
DC-FPX_truncate(length) | Das Einzel-Tag kürzt den Inhalt auf | Template: Ausgabe: |
Bemerkung:
Man kann auch Tags wie z. B. ~PR-Name~ verwenden, um einen Parameter zu setzen. Jedoch kann es hier zu Problemen kommen, wenn der Inhalt Kommas beinhaltet.
Dies ist leider der Implementation von den DC- und PR-Tags geschuldet, da hier 2 unterschiedliche Templateparser nacheinander ausgeführt werden.
Beim ersten Lauf werden die PR-Tags ersetzt und im zweiten die DC-Tags. Dadurch kann es dann passieren, dass im PR-Tag ein Komma beinhaltet. Dadurch wird dann beim zweiten Parsen gedacht, dass der DC-Tag mehr als nur einen Parameter beinhaltet. Und deswegen würde dann nur der Inhalt bis zum ersten Komma registriert.
scroll-content-blockdas als Argument verwendete Tag (nach dem Parsen) Kommas enthält.
"PRCONV-" Tags
Die PRCONV-Tags stehen für Produktdatenfelder, die auf irgendeine Weise konvertiert werden müssen, bevor sie in das Template eingefügt werden können. Derzeit besteht die einzige Konvertierungsmöglichkeit darin eine Tabelle anzugeben, in der die Original-Werte und die konvertierten Werte aufgeführt sind.
Alle zu konvertierenden Felder müssen in der Datei "convert-fields.csv" in dem Ausgabeverzeichnis der Exportdateien eingetragen werden. Diese Datei enthält drei Spalten:
Org-Name: Der Name des Produktdatenfeldes, z.B. "VATIndex"
Conv-Name: Der konvertierte, im Template verwendete Name (ohne den Präfix PRCONV-), z.B. "Tax"
Table: Der Dateiname der Konvertierungstabelle. Die Datei muss ebenfalls in dem Ausgabeverzeichnis liegen, Pfadangaben in diesem Feld sind nicht zulässig.
Die Datei der Konvertierungstabelle enthält folgende Spalten:
Org-Value: Der Wert des Produktdatenfeldes, z.B. "1". Ein "*" steht für den Default-Wert der verwendet wird, wenn kein passender Eintrag in der Tabelle gefunden wird.
Conv-Value: Der konvertierte Wert, z.B. "0.19".
"Cat-" Tags
Mit den Cat-Tags lassen sich Kategoriedaten innerhalb der Produktschleife ({@PR-Articles}) einfügen.
...
| Scroll content block | ||||||
|---|---|---|---|---|---|---|
Formatierungs-Tags/Formatierung von CSV-DateienDamit Export-Templates von CSV-Dateien übersichtlicher gestalteten werden können gibt es die folgenden Formatierungs-Tags:
Zusammen mit der Option “Zeilenumbrüche entfernen” wird es dadurch möglich die einzelnen Felder der Exportdatei im Template übersichtlich untereinander in das Template zu schreiben. Beispiel: Insbesondere bei Exportdateien mit vielen Feldern ist dies deutlich übersichtlicher als alle Tags in eine Zeile zu schreiben. | ||||||
Kategoriedatenexport
Der Export von Kategoriedaten unter Benutzung eines Templates wird aktiviert, in dem die zugehörige Template-Datei in das Ausgabeverzeichnis der Exportdatei kopiert wird. Der Name dieser Datei ist fest vorgegeben und lautet "category-template.txt".
Im Gegensatz zu den Produktdaten können Kategoriedaten ausschließlich unter Benutzung eines Templates exportiert werden.
Unterstützte Tags
Tag | Beschreibung |
|---|---|
{@Cat-Categories} | Die Schleife der Kategoriedaten |
~Cat-Name~ | Der Name der Kategorie innerhalb von {@Cat-Categories} |
~Cat-Index~ | Der Index der Kategorie innerhalb von {@Cat-Categories} |
~Cat-Descr~ | Die Beschreibung der Kategorie innerhalb von {@Cat-Categories} |
~Cat-ImgAdvNav~ | Erweitertes Navigationsbild |
~Cat-ImgClosed~ | Navigationsgrafik geschlossen |
~Cat-ImgOpen~ | Navigationsgrafik geöffnet |
~Cat-ImgOverview~ | Übersichtsbild |
~Cat-ImgSelected~ | Navigationsgrafik ausgewählt |
{@Cat-ParentCategories} | Die übergeordneten Kategorien. Innerhalb der Schleife ändert sich der Kontext und die Tags ~Cat-Name~ usw. beziehen sich auf die Parentkategorie. Weiterhin kann in dieser Schleife die Klammerung {Cat-last} bzw. {!Cat-last} verwendet werden. |
{@Cat-RevParentCategories} | Wie {@Cat-ParentCategories}, aber in umgekehrter Reihenfolge (von oben nach unten in der Hierarchie) |
~Cat-Link~ | Link zur Kategorie (SEO-URL-fähig) |
...