Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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-" Tags

Tags 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

~EXP-ShopId~

Die ID des Shops

~EXP-Counter~

Ein Zähler, der bei jedem Export hochgesetzt wird.

...

  • Die Parameter, die beim Start-Tag angegeben wurden, müssen beim End-Tag ebenfalls angegeben werden.

  • Für alle DC-Tags sind auch negative Klammerungen möglich.

"DC-FPX" Tags

Mit den DC-FPX-Tags kann man freie Parameter mit selbst gewählten Werten setzen, bearbeiten und ausgeben. Anstelle des X wird ein frei definierbarer, alphanumerischer Parametername geschrieben (in den folgenden Beispiel ist das die “1“).

...

Bemerkung:
Man kann auch Tags wie z. B. ~PR-Name~ verwenden, um einen Parameter zu setzen. Jedoch kann es hier zu Problemen kommen, wenn das als Wert 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.

...

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.

...

Es ist auch möglich außerhalb von PR-Articles sämtliche Kategorien aufzulisten. Dann können alle vom Kategorieexport unterstützten Tags verwendet werden (siehe unten).

Spezialtags

Für komplexe Strukturen, die sich nicht mit den normalen Produkt- und Kategorie-Tags generieren lassen gibt es folgende Spezial-Tags:

Tag

Beschreibung

~BMECat-CategoryStructur~

Kategoriestruktur so wie sie im BMEcat-Standard festgelegt ist

~BMECat-GroupMap~

Zuordnung Produkte -> Kategorie nach BMEcat-Standard

Konfiguration von Spezialfeatures

Spezialfeatures, die sich nicht mit dem Template und über Tags alleine realisieren lassen, können in der Datei "special.ini" in dem Ausgabeverzeichnis der Exportdateien konfiguriert werden. In dieser Datei gibt es einen Pflichtparameter "Feature". Die weiteren Parameter hängen davon ab, welcher Wert unter "Feature" eingetragen ist.

...

Name

Beschreibung

Sport-Tec-Prices

Bei diesem Feature werden die Preise eines anderen Subshops beim Export mit ausgegeben. Welcher Subshop das ist wird über den Parameter "SrcSubshop" festgelegt. Die zusätzlich Preise können über ~STP-Price~, ~STP-BulkAmount~, ~STP-BulkPrice~, {@STP-BulkPrices} in das Template eingefügt werden.

Formatierungs-Tags/Formatierung von CSV-Dateien

Damit Export-Templates von CSV-Dateien übersichtlicher gestalteten werden können, gibt es die folgenden Formatierungs-Tags:

...

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)

Filter-Tags

Folgende Tags können verwendet werden um Kategorien auszublenden, die nicht exportiert werden sollen.

Tag

Beschreibung

{Cat-FilterEq(<Feldname>,<Feldwert>)}

z. B. {Cat-FilterEq(Test,y)}

Die Klammerung wird angezeigt, wenn das Feld den angegebenen Wert hat

{Cat-FilterNEq(<Feldname>,<Feldwert>}

z. B. {Cat-FilterNEq(Name,Sonderangebote)}

Die Klammerung wird angezeigt, wenn das Feld nicht den angegebenen Wert hat

{Cat-<Feldname>}

z. B. {Cat-Descr}

Die Klammerung wird angezeigt, wenn das Feld gefüllt ist

Formatierungs-Tags/Formatierung von CSV-Dateien

Wie bei den Produktdaten stehen auch bei den Kategoriedaten die Formatierungs-Tags ~t~ und ~n~ zur Verfügung (siehe oben).