Advanced Field Functions
Advanced Field Codes are especially suitable for custom formatting, calculations and queries of individual column contents in imports and exports. Please pay attention to the correct use of the pipe |, the single quotes' and the curved {} and square [] brackets.
Please, use these functions only as specified in the examples herein. We do not provide support for faulty, multiple or incorrectly nested functions that are not listed in the following examples.
Inhaltsverzeichnis
- 1 spec* - Usage of additional Data Fields
- 2 Format, calculate and filter cell content
- 2.1 replace - Feldinhalt ersetzen
- 2.2 truncate - Feldinhalt kürzen
- 2.3 lowercase - Cell Content with lower Case Letters
- 2.4 net - Net Price
- 2.5 html - Text with HTML
- 2.6 text - Text w/o HTML but, with Linebreaks
- 2.7 clear - Text w/o HTML and w/o Linebreaks
- 2.8 split - Extracting Data from a Data Field with Separators
- 2.9 math - Calculations
- 2.10 date() - Date Values
- 3 Nesting of Functions
- 4 Conditional Statements and Branches (Queries)
- 5 Interfaces specific Placeholders
spec* - Usage of additional Data Fields
Up to 20 additional, individual fields, e.g. for columns of the import file that do not match any of the existing field labels, can be defined under Data Pool ->Preferences ->Actions. The assignment of these free fields is done in the Import and Export settings via the placeholder [spec1], [spec2], and so on ... up to [spec20].
- spec1, spec2, spec3, spec4 usw. - Freifelder zuweisen
Beispiel: Sie haben Ihrem 1. Freifeld den Namen MobileLink gegeben, da Ihre Importdatei eine solche Spalte mit entsprechenden Werten enthält. Auslesen bzw. zuweisen lassen sich alle Werte dieser Spalte mit folgendem Platzhalter:
[spec1]
Format, calculate and filter cell content
replace - Feldinhalt ersetzen
Die Funktion replace ersetzt einen Wert durch einen anderen. Als Trenner kann ein beliebiges Zeichen festgelegt werden. Es darf jedoch nicht der Wert sein, der ersetzt werden soll. Innerhalb von replace werden keine Hochkommas verwendet.
Beispiel 1... Das Komma im Feld price wird durch einen Punkt ersetzt. Trenner ist die Pipe (|).
[price|replace|,|.]
Beispiel 2... Doppelte Doppelpunkte im Feld attributes werden durch einen Doppelpunkt ersetzt. Trenner in der Funktion ist das Doppelkreuz (#).
[attributes|replace#::#:]
truncate - Feldinhalt kürzen
Beispiel... Vom Feld 'Bildname1' Ihrer Importdatei werden nur die ersten 4 Zeichen ausgegeben bzw. importiert:
[pic1|truncate:4]
Beispiel... Aus Ihrer Art.-Nummer möchten Sie 6 Zeichen ab Position 3 importieren:
[itemno|truncate:6:3]
lowercase - Cell Content with lower Case Letters
Beispiel... Bildname1 "GTN765.jpg" soll in Kleinbuchstaben (gtn756.jpg) umgewandelt werden:
[pic1|lowercase]
net - Net Price
Beispiel... Ihre Importdatei beinhaltet Bruttopreise. Sie benötigen den Preis jedoch netto, abzgl. (19%) Mehrwersteuer:
[price|net]
html - Text with HTML
Beispiel... Alle Beschreibungstexte sollen mit HTML-Befehlen importiert werden (wenn vorhanden):
[description|html]
text - Text w/o HTML but, with Linebreaks
Beispiel... Aus den Artikelbeschreibungen Ihrer Importdatei werden ggf. vorhandene HTML-Tags entfernt und nur der eigentliche Text wird importiert. Zeilenumbrüche im Text werden formatiert ausgegeben:
[description|text]
clear - Text w/o HTML and w/o Linebreaks
Beispiel... Alle Beschreibungen werden unformatiert und ohne Zeilenumbrüche als fortlaufender Text dargestellt:
[description|clear]
split - Extracting Data from a Data Field with Separators
Beispiel 1... Feldinhalt sieht wie folgt aus: "Bildpfad1|Bildpfad2|Bildpfad3]". Als Datentrenner im System bei uns ist als Standardtrenner die Pipe | voreingestellt (senkrechter Strich). Es soll nur der Wert 'Bildpfad2' übernommen werden:
[FeldNameBild|split:2]
Beispiel 2... Feldinhalt: "Bildpfad1|-|Bildpfad2|-|Bildpfad3". Datentrenner 2 Pipes mit Bindestrich in der Mitte |-| (als Beispiel für einen eigenen Trenner). Aus dem Feldinhalt mit 3 Werten soll nur der Wert "Bildpfad3" übernommen werden:
[FeldNameBild|split:3:|-|]
Beispiel 3... Feldinhalt eines Feldes 'Category': "Möbel|Wohnzimmer|Sessel". Datentrenner ist wieder die Pipe. Wenn Sie einen anderen Trenner verwenden, dann bitte im Beispiel 2 schauen. In 3 Spalten wird die Übernahme der einzelnen Werte "Möbel", "Wohnzimmer" und "Sessel" wie folgt vorbereitet:
[Category|split:1] [Category|split:2] [Category|split:3]
math - Calculations
Beispiel 1... Addiere 100 auf den aktuellen Preis:
[math|price+100]
Beispiel 2... Multipliziere den aktuellen Preis mit 1.5, benutze als Dezimaltrennzeichen den Punkt:
[math|price*1.5|.]
Beispiel 3... Addiere Inhalte aus den Feldern 'price' und 'shippingCost':
[math|price+shippingCost]
Beispiel 4... Addiere/berechne 4 Werte in einem Feld: Importpreis [price_list] + Mehrwertsteuer [vat] + 20% Aufschlag + 5 Euro pauschal
[math|price_list*1.vat*1.2+5]
date() - Date Values
Beispiel 1... Aktuelles Startdatum mit Angabe Stunde und Minute (z.B. für Auktionen):
date(d.m.Y H:i)
Beispiel 2... Aktuelles Startdatum mit zusätzlicher Angabe der Sekunden ausgeben:
date(d.m.Y H:i:s)
Beispiel 3... Startdatum mit Stunde und Minute jedoch 2 Tage zurück gesetzt:
date(d.m.Y H:i|-2)
Nesting of Functions
[func1 {func2}] - Joining two Functions
Beispiel 1... Ersetzt in einem String https in http und a-domain.com in b-domain.com:
[pic1|replace:'https':'http'{replace:'a-domain.com':'b-domain.com'}]
Beispiel 2... Sie möchten Datumswerte, z.B. "10.09.2015 17:55:49" in "10.09.2016" ändern. Dazu muss der 1. Teil des Datums gesucht und '2015' durch '2016' ersetzt werden. Der Trenner ist das Leerzeichen:
[Datum|split:1: {replace:'2015':'2016'}]
[func1 {func2}{func3}] - Joining three Functions
Beispiel... Der Titel "Kette, schwarz-rot Metallik, 80cm" wird in "metallic" umgewandelt. Dazu muss der 3. Teil des Titels gesucht, alle Buchstaben klein geschrieben und ein Buchstabe ersetzt werden. Als Trennzeichen der Werte innerhalb des Titels wird das Leerzeichen definiert (vor der ersten geschwungenen Klammer):
[title|split:3: {lowercase}{replace:'k':'c'}]
Conditional Statements and Branches (Queries)
IF - Statement
Beispiel... Wenn 'SpalteBestand' Wert größer 5, schreibe 5 - ansonsten schreibe nichts in das Feld:
{IF 'SpalteBestand' > '5'}5{ENDIF}
IF-ELSE - Statement
Beispiel 1... Wenn 'SpalteVerfuegbar' Wert nicht wie 'ja', schreibe 0 - ansonsten schreibe 1.
{IF 'SpalteVerfuegbar' != 'ja'}0{ELSE}1{ENDIF}
Beispiel 2... Wenn 'Lager' Wert leer, schreibe 'nein' - ansonsten schreibe 'ja'.
{IF 'Lager' == ''}nein{ELSE}ja{ENDIF}
IF-ELSEIF-ELSE - Statement
Beispiel 1... Wenn 'SpalteVerfuegbar' Wert=nein, schreibe 0 - wenn 'SpalteVerfuegbar' Wert=ja, schreibe 1 - wenn Beides nicht zutrifft schreibe nichts in das Feld.
{IF 'SpalteVerfuegbar' == 'nein'}0{ELSEIF 'SpalteVerfuegbar' == 'ja'}1{ELSE}{ENDIF}
Beispiel 2... ist etwas komplexer. Es gibt z.B. Variantenfelder für Konfektionsgrößen. Der folgende Code ersetzt die Größenangaben 36-54 aus der Importdatei (Feldname: 'Variation_Size') in die gewünschten Buchstaben-Größenbezeichner, z.B. S, M, L, XL usw.:
{IF 'Variation_Size' == '36'}XXS
{ELSEIF 'Variation_Size' == '38'}XS
{ELSEIF 'Variation_Size' == '40'}S
{ELSEIF 'Variation_Size' == '42'}M
{ELSEIF 'Variation_Size' == '44'}L
{ELSEIF 'Variation_Size' == '46'}XL
{ELSEIF 'Variation_Size' == '48'}XXL
{ELSEIF 'Variation_Size' == '50'}3XL
{ELSEIF 'Variation_Size' == '52'}4XL
{ELSEIF 'Variation_Size' == '54'}5XL
{ELSE}6XL
{ENDIF}
IF-ELSE-ELSE - Statement
Beispiel... Wenn Spalte 'Aktiv' Wert='Ja', übernehme Wert aus Spalte 'Bestand' - ansonsten wenn Wert 'Bestand' größer 10, schreibe '10' - ansonsten schreibe '0' in das Feld.
{IF 'Aktiv' == 'Ja'}[Bestand]{ELSE}{IF 'Bestand' > '10'}10{ELSE}0{ENDIF}{ENDIF}
Interfaces specific Placeholders
WooCommerce
ASIN-Platzhalter
[ASIN-{COUNTRY}]
More functions will be added as required and on request.
