Versions Compared

Key

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

scroll-

...

template-idef6af82b-f039-4de1-9c19-9b84d787fd5c
scopecurrent
captionexport to pdf
quick-starttrue
add-onScroll PDF Exporter
scroll-ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-htmltrue
scroll-epubtrue
16falselistfalse

...

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

Sobald auf dem export-template.txt Umlaute als Spaltenüberschriften oder bei den fixen Ausgabefeldern verwendet werden, muss die Codierung des Templates Unicode oder Ansii sein.

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.

...

Tag

Beschreibung

{@PR-Articles}

Schleife über alle Produktdaten

{@PR-SearchItems}

Schleife für die Suchbegriffe. Zur Ermittlung der einzelnen Begriffe wird das Feld searchitems in einzelne Wörter aufgespalten. Als Trennzeichen gelten hier alle Zeichen, die keine Buchstaben oder Ziffern sind.

{PR-DepVariations}

Klammerung die angezeigt wird, wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ aktiviert ist und ein Produkt abhängige Varianten hat.

{@PR-DepVariations}

Schleife für Namen und Werte der abhängigen Variationen. Innerhalb der Schleife können die Tags ~PR-DepVariationName~, ~PR-DepVariationValue~, ~PR-DepVariationIdx~ und {last} verwendet werden

Die gesamte Schleife sollte zusätzlich mit {PR-DepVariations}...{/PR-DepVariations} geklammert werden, da die Schleifen-Tags nicht ersetzt werden, wenn ein Produkt keine Varianten hat.

Diese Schleife ist nur sinnvoll, wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ aktiviert ist.

{PR-DepVarProducts}

Klammerung wird eingeblendet, wenn die Schleife {@PR-DepVarProducts} Einträge enthält, d.h. ein Produkt abhängige Variationen hat und die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

{@PR-DepVarProducts}

In dieser Schleife können die Produktdaten von abhängigen Variationen eingefügt werden.

Beispiel:

Code Block
{@PR-DepVarProducts}
  <Name>~PR-Name~</Name>
{/@PR-DepVarProducts}

Innerhalb der Schleife können alle „einfachen“ Produktdaten-Tags verwendet werden, d. h. keine Tags die Konvertierungen erfordern, Schleifen benötigen, usw.

Die Schleife kann mehrfach eingefügt werden, wenn z. B. erst eine Liste mit Produktnummern erzeugt werden soll und dann eine Liste der Produktnamen.

Diese Schleife ist nur sinnvoll wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

{PR-DistinctDepVarField}

Klammerung wird eingeblendet, wenn die Schleife {@PR-DistinctDepVarField} Einträge enthält, d. h. ein Produkt abhängige Variationen hat und die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

{@PR-DistinctDepVarField(...)}

Diese Schleife erlaubt es die unterschiedlichen Werte für ein einzelnes Produkt-Attribut auszugeben, dessen Name als Parameter angegeben werden muss.

Beispiel:
Ein Produkt hat drei abhängige Varianten, bei denen das freie Feld „Farbe“ gefüllt ist. Bei zwei Varianten hat dieses Feld den Wert „rot“, bei einem den Wert „grün“.

Die Schleife

Code Block
{@PR-DistinctDepVarField(Farbe)}
  ~PR-Farbe~
{/@PR-DistinctDepVarField(Farbe)}

würde nun durch die Werte
rot
grün
ersetzt.

Diese Schleife ist nur sinnvoll wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

{PR-DepVarNames}

Klammerung die eingeblendet wird, wenn die Schleife {@PR-DepVarNames} Einträge enthalten würde, d.h. ein Produkt abhängige Variationen hat und die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

{@PR-DepVarNames}/
{@PR-DepVarValues}

Diese beiden Schleifen sind dafür gedacht die Namen und Werte der abhängigen Variationen für ein Produkt einzufügen.
Innerhalb der Schleife können die Tags ~PR-DepVariationName~ (Name der Variation) und ~PR-DepVariationValue~ (Wert der Variation) verwendet werden.

Diese Schleifen können nur verwendet werden, wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

Beispiel:

Code Block
{@PR-DepVarNames}
  ~PR-DepVariationName~
  {@PR-DepVarValues}
    ~PR-DepVariationValue~
  {/@PR-DepVarValues}
{/@PR-DepVarNames}

Ergebnis für ein Produkt mit den Varianten „Farbe und Größe“ mit den Werten „rot“ und „grün“ bzw. „L“ und „XL“:
Farbe
rot
grün
Größe
L
XL

{PR-DepVarField}

Klammerung für {@PR-DepVarField(...)} Schleifen

{@PR-DepVarField(...)}

Schleife mit der sich Varianten-Werte verschachtelt einfügen lassen.

Diese Schleife kann nur verwendet werden, wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

Beispiel:

Code Block
{PR-DepVarField}
  {@PR-DepVarField(Farbe)}
    ~PR-DepVariationValue(Farbe)~
    {@PR-DepVarField(Größe)}
      ~PR-DepVariationValue(Größe)~
      price: ~PR-Price~
    {/@PR-DepVarField(Größe)}
  {/@PR-DepVarField(Farbe)}
{/PR-DepVarField}

Ergebnis für ein Produkt mit den Varianten „Farbe und Größe“ mit den Werten „rot“ und „grün“ bzw. „L“ und „XL“:
rot
L
price: 10,000
XL
price: 15,000
grün
L
price: 10,000
XL
price: 15,000

{LastDepVarField}

Klammerung, die eingeblendet wird, wenn in der Schleife {@PR-DepVarField} der letzte Eintrag der aktuellen Varianten-Wert-Liste erreicht wurde.

{PR-DepVarAttribute1...N}
~PR-DepVarAttribute1...N~

Klammerung ob das Produkt das N-te Attribut besitzt.
Die Klammerung kann verschachtelt werden.

Wichtig: Die äußerste Klammerung muss immer {PR-DepVarAttribute1} sein. Innerhalb des Bereichs kann der Attributname durch das Einzel-Tag ausgegeben werden.

Beispiel:

Code Block
// Verarbeitung wenn Produkt mind. 1 Attribut besitzt
{PR-DepVarAttribute1}
  // Schleife über alle Werte des ersten Attributs
  {@PR-DepVarValues1}
    // Ausgabe des zweiten Attributs bei mind. 2 Attribute
    {PR-DepVarAttribute2}
      // Schleife über alle Werte des zweiten Attributs
      {@PR-DepVarValues2}            
        ~PR-DepVarAttribute1~: ~PR-DepVarValue1~ /
        ~PR-DepVarAttribute2~: ~PR-DepVarValue2~ /
        Preis: ~PR-Price~
      {/@PR-DepVarValues2}
    {/PR-DepVarAttribute2}
    // Alternative Ausgabe, wenn Produkt nur ein Attribut besitzt
    {!PR-DepVarAttribute2}
      ~PR-DepVarAttribute1~: ~PR-DepVarValue1~ /
      Preis: ~PR-Price~
    {/!PR-DepVarAttribute2}
  {/@PR-DepVarValues1}
{/PR-DepVarAttribute1}

Ergebnis für ein Produkt mit den Varianten „Farbe und Größe“ mit den Werten „rot“ und „grün“ bzw. „L“ und „XL“:
Farbe: rot / Größe: L / Preis: 10,000
Farbe: rot / Größe: XL / Preis: 11,000
Farbe: grün / Größe: L / Preis: 10,000
Farbe: grün / Größe: XL / Preis: 11,000

Ergebnis für ein Produkt mit der Variante „Farbe“ mit den Werten „rot“, „grün“ und „blau“:
Farbe: rot / Preis: 10,000
Farbe: grün / Preis: 10,000
Farbe: blau / Preis: 10,000

Diese Klammerung kann nur verwendet werden, wenn die Option „Abhängige Variationen (als eigenständige Produkte) exportieren“ nicht aktiviert ist.

{@PR-DepVarValues1...N}

Schleife über alle aktiven Werte des N-ten Attributs.

Wird über die Werte des letzten Attributs durchgegangen; damit können die Variantendaten ausgegeben werden.

Die Schleife kann nur innerhalb von {PR-DepVarAttribute1...N} verwendet werden.

{LastDepVarValue}
{!LastDepVarValue}

Prüfung, ob der letzte Wert innerhalb von {@PR-DepVarValues1...N} erreicht wurde

~PR-DepVarValue1…N~

Ausgabe des Werts vom N-ten Attributs.

Muss innerhalb von {@PR-DepVarValues1...N} verwendet werden

{@PR-C-Links}
{@PR-C-Links2}
{@PR-C-Links3}
{@PR-C-Links4}
{@PR-C-Links5}{@PR-CS-Links}

Schleife für XLinks. Schleife für Cross-Links (Zubehörprodukte/XLinks).
Innerhalb der Schleife können die Tags ~PR-Number~, ~PR-ProdIndex~ und {last} verwendet werden.

{@PR-CS-Links}

Schleife für CrossSelling-Links.
Innerhalb der Schleife können die Tags ~PR-Number~, ~PR-ProdIndex~ und {last} verwendet werden.

{@PR-BulkPrices}

Die Schleife mit den Staffelpreisen. Innerhalb der Schleife können die Tags ~PR-BulkAmount~, ~PR-BulkPrice~, ~PR-BulkPriceNet~, ~PR-BulkPriceGross~ und {last} verwendet werden

~PR-SearchItem~

Suchbegriff innerhalb der {@PR-SearchItems} Schleife

~PR-BulkAmount~

Menge innerhalb der {@PR-BulkPrices} Schleife

~PR-BulkPrice~

Preis innerhalb der {@PR-BulkPrices} Schleife

~PR-BulkPriceNet~

Der aus ~PR-BulkPrice~ berechnete Netto-Preis innerhalb der {@PR-BulkPrices} Schleife

~PR-BulkPriceGross~

Der aus ~PR-BulkPrice~ berechnete Brutto-Preis innerhalb der {@PR-BulkPrices} Schleife

~PR-PriceNet~

Der aus ~PR-Price~ berechnete Netto-Preis

~PR-PriceGross~

Der aus ~PR-Price~ berechnete Brutto-Preis

~PR-DepVariationName~

Variationsnamen innerhalb der {@PR-DepVariations} Schleife

~PR-DepVariationValue~

Variationswert innerhalb der {@PR-DepVariations} Schleife

~PR-DepVariationIdx~

Fortlaufende Nummer der Variation innerhalb der {@PR-DepVariations} Schleife

~PR-DeliveryText~

Der Lieferstatustext, ermittelt aus dem Bestand zum Zeitpunkt des Exports

~PR-DeepLink~

Der Link zum Aufruf des Produkts

~PR-DeepLinkPath~

Der Pfad-Teil des Links zum Aufruf des Produkts

~ENCXML-PR-DeepLink~

Der Link zum Aufruf des Produkts (XML-kodiert)

{PR-CanonicalDeepLink}

Prüft, ob ein Canonical Link für das Produkt hinterlegt ist

~PR-CanonicalDeepLink~

Ausgabe des Canonical Links des Produktes (falls vorhanden)

~ENCXML-PR-CanonicalDeepLink~

XML-codierte Ausgabe des Canonical Links des Produktes (falls vorhanden)

Code Block
{@PR-Articles}
<url>~n~
   <loc>
      {PR-CanonicalDeepLink}
         ~ENCXML-PR-CanonicalDeepLink~
      {/PR-CanonicalDeepLink}
      {!PR-CanonicalDeepLink}
         ~ENCXML-PR-DeepLink~
      {/!PR-CanonicalDeepLink}
   </loc>~n~
   <lastmod>
      ~PR-LastModDate~
   </lastmod>~n~
</url>~n~
{/@PR-Articles}

{PR-IsCanonicalDeepLink}

Prüft, ob Produktlink und Canonical Link des Produktes übereinstimmen (nur bei multiplen Export von Produkten nötig)

~PR-LastModDate~

Datum der letzten Änderung an dem Produkt

{PR-NamedImageURL(FELDNAME)}

Prüft, ob benamte Bild-URLs für das angegebene Feld aktiv ist

~PR-NamedImageURL(FELDNAME)~

Ausgabe der benamten Bild-URL für das angegebene Feld (nur innerhalb von {PR-NamedImageURL(FELDNAME)} nutzbar)

Code Block
{PR-NamedImageURL(Image)}
   <image:image>~n~
      <image:loc>
         https://doma.in/path/to/file/~PR-NamedImageURL(Image)~
      </image:loc>~n~
   </image:image>~n~
{/PR-NamedImageURL(Image)}

~PR-Amount~

Der Lagerbestand

~PR-ParentNumber~

Produktnummer des Stammartikels
(nur bei abhängigen Varianten)

~PR-DeliveryCosts~

Die Lieferkosten für das Produkt anhand der im OSB-Dienst konfigurierten Voreinstellungen / Liefergruppen

~PR-DeliveryCostsGoogleShopping~

Die Lieferkosten für Google Shopping

~PR-RatingVotes~

Anzahl Userbewertungen

~PR-RatingScore~

Durchschnittsbewertung (zwischen 1 und 10)

~PR-RatingScore(min, max)~

Durchschnittsbewertung (zwischen min und max).
Es kann nur entweder dieses Tag oder ~PR-RatingScore~ verwendet werden.

{@PR-RatingVotes}

Schleife über alle Einzelbewertungen zu dem Produkt

~PR-RatingText~

Verfasster Bewertungstext
Nur verwendbar innerhalb von {@PR-RatingVotes}

{PR-RatingText}
{!PR-RatingText}

Prüfung ob ein Text bei der Einzelbewertung verfasst wurde.
Nur verwendbar innerhalb von {@PR-RatingVotes}

~PR-RatingSubject~

Verfasster Bewertungsbetreff
Nur verwendbar innerhalb von {@PR-RatingVotes}

{PR-RatingSubject}
{!PR-RatingSubject}

Prüfung ob ein Betreff bei der Einzelbewertung verfasst wurde.
Nur verwendbar innerhalb von {@PR-RatingVotes}

~PR-RatingEmail~

E-Mail-Adresse des Bewerters
Nur verwendbar innerhalb von {@PR-RatingVotes}

{PR-RatingEmail}
{!PR-RatingEmail}

Prüfung ob eine E-Mail Adresse bei der Bewertung hinterlegt wurde.
Nur verwendbar innerhalb von {@PR-RatingVotes}

~PR-RatingNickname~

Hinterlegter Nickname zur Bewertung
Nur verwendbar innerhalb von {@PR-RatingVotes}

{PR-RatingNickname}
{!PR-RatingNickname}

Prüfung ob ein Nickname bei der Bewertung hinterlegt wurde.
Nur verwendbar innerhalb von {@PR-RatingVotes}

~PR-RatingVote~

Einzelbewertung
Nur verwendbar innerhalb von {@PR-RatingVotes}

~PR-RatingID~

Bewertungs-ID
Nur verwendbar innerhalb von {@PR-RatingVotes}

~PR-RatingTimestamp~

Zeitpunkt der Bewertung. Format: YYYY-mm-DD HH:MM:SS
Nur verwendbar innerhalb von {@PR-RatingVotes}

{PR-Inventory}

Bereich wird angezeigt, wenn für ein Produkt die Lagerbestandsverwaltung aktiviert wurde.

{PR-InventoryState(state)}

Lagerbestands-Status

Mögliche Werte:
- green
- yellow
- red (=red-soft oder red-hard)
- red-soft
- red-hard

Es können mehrere Werte kommasepariert angegeben werden. (Siehe Shopdokumentation: PR-InventoryState)

Sollte nur innerhalb von {PR-Inventory} verwendet werden.

Beispiel:

Code Block
{PR-InventoryState(green)}
   Sofort lieferbar
{/PR-InventoryState(green)}

{@PR-DistinctArticles(Feldname)}

Schleife für alle Produktdaten.

Für jeden unterschiedlichen Feldwert des Produktdatenfeldes, das mit dem Parameter übergeben wird, wird jeweils nur das erste gefundene Produkt ausgegeben.

Beispiel:
Produktdaten
Index Name IS_ZUSATZ0
0001 Prod1 rot
0002 Prod2 grün
0003 Prod3 rot
0004 Prod4 blau
0005 Prod5 grün

Template

Code Block
Index / Name / Farbe
{@PR-DistinctArticles(IS_ZUSATZ0)}
   ~PR-Index~ / ~PR-Name~ / Farbe: ~PR-IS_ZUSATZ0~
{/@PR-DistinctArticles(IS_ZUSATZ0)}

Ergebnis
Index / Name / Farbe
0001 / Prod1 / rot
0002 / Prod2 / grün
0004 / Prod4 / blau

~PR-SalesFigures~

Ausgabe der Verkaufszahlen der letzten 30 Tagen. Gibt bei Varianten die Verkaufszahlen des Basisartikels aus.

~PR-SalesRank~

Ausgabe des Verkaufsranges anhand der Bestelldaten der letzten 30 Tagen. Gibt bei Varianten den Rang des Basisartikels aus.

{PR-ProcessMediaData}

Bereich wird angezeigt, wenn Daten aus der Mediendatenbank kommen. Ist das aktuelle Produkt ein Shopprodukt, wird der Bereich nicht angezeigt

Voraussetzung
- Mediendatenbank (KNV/VLB ist aktiviert)
- Produktdaten besitzen einen GTIN

{PR-LoadMediaData}

Bereich wird angezeigt, wenn Mediendaten zu dem aktuellen Produkt nachgeladen werden konnten. Es wird auch angezeigt wenn das aktuelle Produkt aus der Mediendatenbank stammt.

Voraussetzung
- Mediendatenbank (KNV/VLB ist aktiviert)
- Produkt besitzt ein Feld „GTIN“, das gefüllt ist.

~PR-MediaDataPrice~
~PR-MediaDataATPrice~
~PR-MediaDataCHPrice~

Ausgabe des Preises eines Produkts, der in der Mediendatenbank steht.

(...Price für Deutschland, …ATPrice für Österreich und ...CHPrice für Schweiz)

Voraussetzung
- Mediendatenbank (KNV/VLB ist aktiviert)
- {PR-LoadMediaData} ist positiv

{PR-MediaDataFixedRetailPrice}
{PR-MediaDataFixedRetailPriceAT}
{PR-MediaDataFixedRetailPriceCH}

Bereich wird angezeigt wenn das Produkt im Land preisgebunden ist.

(...Price für Deutschland, …PriceAT für Österreich und ..PriceCH für Schweiz)

Voraussetzung
- Mediendatenbank (KNV/VLB ist aktiviert)
- {PR-LoadMediaData} ist positiv

{PR-MediaDataRetailPrice}
{PR-MediaDataRetailPriceAT}
{PR-MediaDataRetailPriceCH}

Bereich wird angezeigt, wenn das Produkt im Land nicht preisgebunden ist.

(...Price für Deutschland, …PriceAT für Österreich und ..PriceCH für Schweiz)

Voraussetzung
- Mediendatenbank (KNV/VLB ist aktiviert)
- {PR-LoadMediaData} ist positiv

~PR-Ekomi-RatingVotes~

Liest aus external_data.websale_*_rating_ekomi_shop Anzahl der Bewertungen ("NumRatings") für das Produkt aus

{PR-Ekomi-RatingVotes}

Bereich wird angezeigt, wenn Ekomi für den Shop aktiviert ist.

~PR-Ekomi-RatingScore~

Liest aus external_data.websale_*_rating_ekomi_shop die durchschnittliche Bewertung ("AverageRating") für das Produkt aus.

{PR-Ekomi-RatingScore}

Bereich wird angezeigt, wenn Ekomi für den Shop aktiviert ist.

{@PR-Ekomi-Ratings}

Schleife über die einzelnen Ekomi Bewertungen zu einem Produkt

{PR-Ekomi-Text}

Bereich wird angezeigt, wenn Ekomi für den Shop aktiv ist.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

~PR-Ekomi-Text~

Tag zur Ausgabe des Ekomi Bewertungstextes für ein Produkt.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

{PR-Ekomi-ReviewID}

Bereich wird angezeigt, wenn Ekomi für den Shop aktiv ist.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

~PR-Ekomi-ReviewID~

Tag zur Ausgabe der aus OrderID, ProduktIndex und einem Salt berechneten, eindeutigen ReviewID einer Ekomi-Bewertung.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

{PR-Ekomi-Timestamp}

Bereich wird angezeigt, wenn Ekomi für den Shop aktiv ist.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

~PR-Ekomi-Timestamp~

Das Tag gibt den Zeitstempel der Ekomi-Bewertung aus.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

{PR-Ekomi-Vote}

Bereich wird angezeigt, wenn Ekomi für den Shop aktiv ist.

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

~PR-Ekomi-Vote~

Tag zur Ausgabe der Ekomi Bewertung

Nur in der Schleife @PR-Ekomi-Ratings nutzbar

~PR-CreationDate~

Das Tag gibt den Zeitstempel der Produkterstellung aus.

...

Code Block
{@Cat-AllAssigned}
  <Name>~Cat-Name~</Name>
  <Link>~Cat-Link~</Link>
{/@Cat-AllAssigned}

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).

“Tpl-” Tags

Für die Ausgabe von URLs der (statischen) Informationsseiten des Shops (z. B. für die Erzeugung einer sitemap) stehen folgende Tpl-Tags zur Verfügung.

...

Tag

...

Beschreibung

...

{@Tpl-Template}

...

Loop über alle URLs für Informationsseiten

...

~Tpl-Link~

...

Link zur Informationsseite

...

~Tpl-LastModDate~

...

Datum der letzten Änderung der Template-Datei im Subshop-Verzeichnis

...

Beispiel 3:
Folgendes Beispiel gibt nur alle Indexe aus:

Code Block
{@Cat-AllAssigned}
  ~Cat-Index~
{/@Cat-AllAssigned}


Beispiel 4:
Folgender Code gibt alle Namen die direkt zugeordnet sind und deren Pfad:

Code Block
{@Tpl@Cat-TemplateAllAssigned}
  <assigned>
<url>~n~    <index>~Cat-Index~</index>
    <loc>~Tpl<name>~Cat-Link~</loc>~n~Name</name>
    <path>
      {@Cat-Data}
        <lastmod>~Tpl<part>~Cat-LastModDate~<Name~</lastmod>~n~part>
      <changefreq>weekly</changefreq>~n~
{/@Cat-Data}
    </path>
  </url>~n~assigned>
{/@Tpl@Cat-Template}

Spezialtags

...

AllAssigned}


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).

“Tpl-” Tags

Für die Ausgabe von URLs der (statischen) Informationsseiten des Shops (z. B. für die Erzeugung einer sitemap) stehen folgende Tpl-Tags zur Verfügung.

Tag

Beschreibung

~BMECat-CategoryStructur~

Kategoriestruktur so wie sie im BMEcat-Standard festgelegt ist

~BMECat-GroupMap~

Zuordnung Produkte -> Kategorie nach BMEcat-Standard

CurrentTimestamp

Zeitpunkt des Exportstarts

Tag

Beschreibung

~CurrentTimestamp~

Gibt den Zeitpunkt vom Start des Exports als Unix-Timestamp aus (Anzahl Sekunden seit 1.1.1970).

{@Tpl-Template}

Loop über alle URLs für Informationsseiten

~Tpl-Link~

Link zur Informationsseite

~Tpl-LastModDate~

Datum der letzten Änderung der Template-Datei im Subshop-Verzeichnis

Beispiel:

Code Block
~DC-FPproductAge_set(~DC-Subtract(~CurrentTimestamp~,~PR-CreationDate~)~)~
{DC-CompareDigitLT(~DC-FPproductAge~, 1209600){@Tpl-Template}
   Das<url>~n~
Produkt wurde innerhalb der letzten 2 Wochen angelegt.
{/DC-CompareDigitLT}

Im Beispiel wird das Anlagedatum vom aktuellen Zeitpunkt abgezogen. Das Ergebnis ist die Zeitspanne seit der Erstellung des Produktes. Das Ergebnis wird in einen freien Parameter (DC-FPproductAge) geschrieben.

Danach wird darauf geklammert ob der Inhalt vom freien Parameter kleiner als 1209600 Sekunden (= 2 Wochen) ist. Nur dann wird der Inhalt innerhalb der Klammer ausgegeben.

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.

Unterstützte Spezialfeatures:

...

Name

<loc>~Tpl-Link~</loc>~n~
      <lastmod>~Tpl-LastModDate~</lastmod>~n~
      <changefreq>weekly</changefreq>~n~
   </url>~n~
{/@Tpl-Template}

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

CurrentTimestamp

Zeitpunkt des Exportstarts

Tag

Beschreibung

~CurrentTimestamp~

Gibt den Zeitpunkt vom Start des Exports als Unix-Timestamp aus (Anzahl Sekunden seit 1.1.1970).

Beispiel:

Code Block
~DC-FPproductAge_set(~DC-Subtract(~CurrentTimestamp~,~PR-CreationDate~)~)~
{DC-CompareDigitLT(~DC-FPproductAge~, 1209600)}
   Das Produkt wurde innerhalb der letzten 2 Wochen angelegt.
{/DC-CompareDigitLT}

Im Beispiel wird das Anlagedatum vom aktuellen Zeitpunkt abgezogen. Das Ergebnis ist die Zeitspanne seit der Erstellung des Produktes. Das Ergebnis wird in einen freien Parameter (DC-FPproductAge) geschrieben.

Danach wird darauf geklammert ob der Inhalt vom freien Parameter kleiner als 1209600 Sekunden (= 2 Wochen) ist. Nur dann wird der Inhalt innerhalb der Klammer ausgegeben.

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.

Unterstützte Spezialfeatures:

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.

...

Tag

Beschreibung

{@Cat-Categories}

Die Schleife der Kategoriedaten

~Cat-Name~

Der Name der Kategorie innerhalb von {@Cat-Categories}

{Cat-Index}

Prüft, ob Kategorie indiziert werden soll oder nicht (RobotIndex = no)

~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)

{@Cat-Data}

Schleife der Kategorie-Namen und -Indexe in normaler Reihenfolge (von “oben” nach “unten” innerhalb der Kategorie-Hierarchie)

Code Block
{@Cat-Data}
   ~Cat-Name~ (~Cat-Index~){!last},{/!last}
{/@Cat-Data}

{@Cat-RevData}

Schleife der Kategorie-Namen und -Indexe in umgekehrter Reihenfolge

{Cat-LastModDate}

Prüft, ob ein Datum der letzten Änderung ermittelt werden konnte

~Cat-LastModDate~

Datum der letzten Änderung an der Kategorie (dabei wird die letzte Änderung der Kategoriezuweisungen berücksichtigt)

Code Block
{@Cat-Categories}
   {Cat-LastModDate}
   <url>~n~
      <loc>~Cat-Link~</loc>~n~
      <lastmod>~Cat-LastModDate~</lastmod>~n~
      <changefreq>weekly</changefreq>~n~
   </url>~n~
   {/Cat-LastModDate}
{/@Cat-Categories}

Filter-Tags

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

...

Tag

...

Beschreibung

...

Anmerkung:
@Cat-Data innerhalb von @Cat-AllAssigned hat eine sehr beschränkte Funktionalität. Man kann nur ~Cat-Name~ und ~Cat-Index~ auslesen. Zudem kann man darin mit {last} prüfen ob es das letzte Element der Liste ist (bei XML aber nicht so wichtig).

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

...

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

URL Angabe zum Triggern eines Imports beim Drittanbieter (Suchdienstleister usw.)


Start des Imports durch das externe System
Bereich “Zeitsteuerung”

...


Unter “URL die nach dem Ende des Exports aufgerufen wird” wird die Trigger URL hinterlegt.
Wenn für den Import eine Authentifizierung erforderlich ist, dann kann diese Angaben in der URL mitgegegeben werden.
Format http(s)://Username:Passwort@domain.de/……..


Zudem kann die HTTP Methode als “GET” oder “POST” ausgewählt werden.
Diese Methode muss der externe Dienstleister mit der URL nennen.

Auf der folgenden Seite finden Sie Beispiel-Dateien: Beispieldateien für WS-DataFlowManager

...