Zuletzt aktualisiert am 1. August 2023
Platzhalter sind ein sehr nützliches Hilfsmittel. Damit können Sie Texte dynamisch aus Artikel- oder deren abhängigen Daten gestalten.
Platzhalter können bei vielen Eingabefeldern, die zur Replikation an einen Webshop dienen, verwendet werden, z.B. bei Artikel-Webshoptexten, Amazon-Feldzuordnungen, eBay-Templates u.v.m. Faktisch wird zum Zeitpunkt der Replikation der Platzhalter durch die genannten Daten des aktuellen Artikels für die aktuelle Filiale (und evtl. die aktuelle Sprache) ersetzt.
Die Platzhalterersetzung ermöglicht nun auch den Zugriff auf freie Felder, die als typ “Tabelle” angelegt wurden. In der Auswahlbox “Tabelle” erscheinen auch die Freie-Felder-Tabellen, in der Auswahlbox “Feld” die Felder dieser Tabelle.
Beispiel: {ART_FF_GRID1.FELD1:WHEREFELD=FELD2:WHEREWERT=”Wert1″}
Es wird Feld1 aus ART_FF_GRID1 ausgegeben, wo Feld2 den Inhalt “Wert1” (ohne Anführungszeichen!) hat. Ist dies nicht eindeutig, so können mehrere Felder und Werte angeben werden:
Beispiel: {ART_FF_GRID1.FELD1:WHEREFELD=FELD2:WHEREWERT=”Wert1″:WHEREFELD=FELD3:WHEREWERT=”Wert2″} usw.
Gibt es mehrere mögliche Ergebnisse, so wird das mit der intern kleinsten ID zurückgeliefert.
Die Syntax eines Platzhalters ist:
{[Tabelle.]Feld/reserviertes Wort[:Optionsname1]…[:OptionsnameN]}
Die geschweiften Klammern sind Pflicht, eckige Klammern werden NICHT verwendet sondern kennzeichnen in der Syntax nur optionale Angaben.
Der Artikel heißt „4711“ mit der Bezeichnung „Hose“.
| Platzhalter | Ergebnis |
| {ART.ARTIKELNR} | 4711 |
| {ART.ARTIKELBEZEICHNUNG1} | Hose |
| {ART.ARTIKELNR}.jpg | 4711.jpg |
| Tabelle | Bedeutung | Abhängig von |
| AAT | sprachabhängige Artikeltexte | Artikel, Sprache |
| ADS | Adressen-Sonderpreise | Artikel, Adresse |
| ART | Artikel | Artikel |
| ART_FF | Artikel – Freie Felder | Artikel |
| ART_FST | Artikel-Status | Artikel |
| BESTAND | Artikelbestandsdaten | Artikel |
| FIL_WEB_ART | Webshop-Artikeldaten | Artikel, Filiale |
| FIL_WEB_ART_AMAZON | Webshop-Artikeldaten Amazon | Artikel, Filiale |
| FIL_WEB_ART_EBAY | Webshop-Artikeldaten eBay | Artikel, Filiale |
| FIL_WEB_ART_SPR | Webshop-Artikeltexte | Artikel, Filiale, Sprache |
| HST | Hersteller | Artikel |
| PREISE | Artikelpreise | Artikel, Filiale |
| Sonstige | Bild-URLs | Artikel, Filiale |
| Varianten | Varianten-Attribute und Werte | Artikel |
Bei Bild-URLs werden die gespeicherten Bildnamen mit der Basis-Bild-URL aus der Filialverwaltung kombiniert.
Beispiel: Bild 2 heißt „hose.jpg“, die Basis-Bild-URL lautet „http://meinserver.de/bilder/“
{Sonstiges.BILD2} ergibt dann “http://meinserver.de/bilder/hose.jpg”. Es wird nicht das Bild selbst ersetzt, sondern nur ein Link dazu generiert!
Tabelle Sonstiges, Bilder:
BILD1 entspricht dem 1. Bild aus der Artikelverwaltung.
VBILD1 entspricht dem 1. Veröffentlichtem Bild aus dem Listing, sprich ist nur Artikelbild 3 veröffentlicht, dann ist VBILD1=BILD3.
Tabelle LIEFERTERMIN: Lieferzeit und Liefertermin eines Artikels.
Tabelle ART_FF_GRID: Freie-Felder-Tabellen, sinnvoll mit den WHERE-Optionen.
Tabelle ART_EAN: Zugriff auf die verschiedenen EAN eines Artikels Beispiel:
{ART_EAN.EAN:POSI=2} 2. EAN eines Artikels.
{EBAY-KOMPATIBILITAET}: gibt eine HTML-Tabelle der Kompatibilitäten eines eBay-Listings aus (Marke, Modell, Plattform, Typ, Baujahr, Motor, Hinweise).
Bestimmte Felder werde intelligent ersetzt, z.B. ist FIL_WEB_ART_AMAZON.SKU leer, wird automatisch mit ART.ARTIKELNR ersetzt, damit die SKU immer ein Ergebnis bringt. Ähnliches funktioniert bei FIL_WEB_ART_AMAZON.PARENT_CHILD für die korrekte Relation bei Varianten (Ergebnis: „Child“ bei Varianten, „Parent“ beim Hauptartikel, sonst nichts), FIL_WEB_ART.EAN (Rückgriff auf ART.EANNR falls leer), FIL_WEB_ART_AMAZON. LEADTIME_TO_SHIP (Beachtung, ob die Artikel-Lieferzeit bei keinem Bestand addiert werden soll).
Sie können durch „file:“ und „http:“ auch lokale Texte sowie Texte aus dem Internet einbinden, die sogar UTF-8 (für nicht-Europäische Schriftzeichen) enthalten können.
{file:c:\texte\test.txt} lädt den Text „test.txt“ aus dem angegeben Pfad
{http:meinserver.de/texte/test.txt} lädt den Text aus der angegeben URL
Zur Ausgabe der eBay-Kompatibilität eines Artikels als HTML-Tabelle können Sie mit {EBAY-KOMPATIBILITAET} darauf zugreifen (erlaubte Optionen: Filiale, Posi).
Optionen sind hilfreich, um den Platzhalter noch weitere Informationen mitzugeben z.B.
Mit „:FILIALE“ können Sie in einer Filiale auf den Text einer anderen Filiale zugreifen. FILIALE muss eine 3-stelliger nummerischer Wert einer existierenden Filiale sein und greift bei Filial-abhängigen Tabellen.
Beispiel: {FIL_WEB_ART.ERSCHEINUNGSDATUM:901} lädt das Erscheinungsdatum aus Filiale 901.
Mit „:SPRACHE“ können Sie auf den Text in einer anderen Sprache zugreifen. SPRACHE muss ein 2-3-stelliger alphanummerischer Wert einer existierenden Sprache sein und greift bei Sprach-abhängigen Tabellen.
Beispiel: {FIL_WEB_ART_SPR.BESCHREIBUNG:EN} lädt den englischen Webshoptext.
Mit „POSI“ können Sie auf den Text eines anderen Listings bei Multilisting zugreifen. POSI muss ein nummerischer Wert eines existierenden Listings sein und greift bei Filial-abhängigen Tabellen. Multilistings existieren nur bei Amazon und eBay-Filialen, alle anderen haben nur Position 1.
Beispiel: {FIL_WEB_ART_EBAY.SKU:POSI=3} lädt die SKU des 3. Listings
Beispiel: {EBAY-KOMPATIBILITAET:POSI=ALL} lädt die Kompat. aller Listings des Artikels (ohne Dubletten).
Liegen Ihre Texte als Plaintext mit normalen Zeilenumbrüchen vor, so werden diese in einem Webshop nicht sauber umgebrochen, weil dort Zeilenumbrüche meist als „<br />“ benötigt werden.
Mit „:TOHTML“ wird das Ergebnis des Platzhalters passend übersetzt.
Beispiel: {ART.ARTIKELTEXT:TOHTML} ersetzt alle Zeilenumbrüche des Artikeltextes HTML-konform.
Die Platzhalterersetzung für Webshoptexte u.a. beherrscht nun auch Ersetzungen:
{ART_FF.FELD1:REPLACE=J=Ja}
bzw.
{ART_FF.FELD1:REPLACE=J=Ja|N=Nein}
:MAX=n schneidert das Ergebnis auf Länge n ab (n >=1)
:KILLBLANKS löscht ALLE Leerzeichen im Ergebnis
:TRIM löscht Leerzeichen am Anfang und Ende des Ergebnisses
MAX wird nach KILLBLANKS/TRIM ausgeführt!
Beispiel:
{ART.ARTIKELBEZEICHNUNG1:MAX=11:KILLBLANKS}
Hans Wurst hat dicke Finger-> HansWurstha
Mit „VHA“ können Sie auf den Text des Varianten-Hauptartikels einer Variante zugreifen. Verwenden Sie die Option bei Nicht-Varianten oder dem Variantenhauptartikel, ist das Ergebnis immer der Artikel selbst.
Beispiel: {ART.ARTIKELNR:VHA} lädt die Artikel-Nr. des Varianten-Hauptartikels.
Mit „BVHA“ können Sie auf den Text des Buche-Von-Hauptartikels einer Variante zugreifen. Verwenden Sie die Option bei Nicht- Buche-Von-Artikeln, ist das Ergebnis immer der Artikel selbst.
Beispiel: {ART.ARTIKELNR:BVHA} lädt die Artikel-Nr. des Buche-Von-Hauptartikels.
Optionen können, wo es sinnvoll ist, kombiniert werden.
Beispiel: {FIL_WEB_ART_SPR.BESCHREIBUNG:EN:901:POSI=3:TOHTML} lädt die englische Webshopbeschreibung der Filiale 901 aus Listing 3 und wandelt es in HTML um.
Sie können auch mehrere Platzhalter hintereinander, kombiniert mit anderen Zeichen, verwenden. Auch Platzhalter in Platzhaltern und Verweise auf andere Platzhalter sind möglich (bis max. 10 Rekursionen).
Webshopbeschreibung: {FIL_WEB_ART_SPR.Kurzbeschreibung}
Kurzbeschreibung: {ART.Artikeltext}
Artikeltext: „Hose“.
Sie verweisen in der Webshopbeschreibung auf die Kurzbeschreibung und die wiederum verweist auf den Artikeltext. Das Ergebnis wäre bei Ausgabe der Webshopbeschreibung der Artikeltext ( „Hose“ ).
Artikel-Nr. 4711
{file:c:\texte\{ART.ARTIKELNR}.txt} lädt den Text „4711.txt“ aus dem angegeben Pfad
Die Platzhalterersetzung beherrscht nun auch die Formatierung von Datums/Zeitfeldern und Zahlen (nur Webshop-Platzhalter). Z.B: