Funktionen

today()

Gibt das aktuellen Datum als DATE-Wert zurück.

now()

Gibt den aktuellen Zeitpunkt als DATETIME-Wert zurück.

bool()

Gibt False zurück.

bool(obj)

Konvertiert obj in einen Boolschen Wert. Das Ergebnis ist False für None, False, die Zahl 0, leere Strings und Listen sowie für leere Zeiträume und True für alle anderen Werte.

Beispiele:

Ausdruck

Wert

bool(None)

False

bool(False)

False

bool(True)

True

bool(0)

False

bool(42)

True

bool("")

False

bool("gurk")

True

bool("0")

True

bool(days(0))

False

bool(days(7))

True

bool(months(0))

False

bool(months(12))

True

bool([1, 2, 3])

True

int()

Gibt 0 zurück.

int(obj)

Konvertiert obj in einen INT-Wert.

Beispiele:

Ausdruck

Wert

Bemerkung

int(False)

0

int(True)

1

int(42)

42

int(42.5)

42

int(-42.5)

-42

int("42")

42

int("42.5")

None

„Fehler“

int("gurk")

None

„Fehler“

float()

Gibt 0.0 zurück.

float(obj)

Konvertiert obj in einen NUMBER-Wert.

Beispiele:

Ausdruck

Wert

Bemerkung

float(False)

0.0

float(True)

1.0

float(42)

42.0

float(42.5)

42.5

float(-42.5)

-42.5

float("42")

42.0

float("42.5")

42.5

float("gurk")

None

„Fehler“

str()

Gibt den leeren String ("") zurück.

str(obj)

Konvertiert obj in einen STR-Wert.

Beispiele:

Ausdruck

Wert

str(None)

"None"

str(False)

"False"

str(True)

"True"

str(42)

"42"

str(42.5)

"42.5"

str("gurk")

None

str([1, 2, 3])

"[1, 2, 3]"

date(jahr, monat, tag)

Erzeugt einen DATE-Wert aus dem übergebenen Jahr-, Monats- und Tagangaben.

Beispiele:

Ausdruck

Wert

Bemerkung

date(2000, 2, 29)

@(2000-02-29)

29. Feb. 2000

datetime(ja, mo, ta, st, mi, se)

Erzeugt einen DATETIME-Wert aus dem übergebenen Jahr-, Monats-, Tag-, Stunden-, Minuten- und Sekundenangeben.

Beispiele:

Ausdruck

Wert

Bemerkung

datetime(2000, 2, 29)

@(2000-02-29T)

29. Feb. 2000 00:00

datetime(2000, 2, 29, 12)

@(2000-02-29T12:00)

29. Feb. 2000 12:00

datetime(2000, 2, 29, 12, 34)

@(2000-02-29T12:34)

29. Feb. 2000 12:34

datetime(2000, 2, 29, 12, 34, 56)

@(2000-02-29T12:34:56)

29. Feb. 2000 12:34:56

len(str)

Gibt die Länge des Strings str zurück.

Beispiele:

Ausdruck

Wert

len("")

0

len("gurk")

4

len(list)

Gibt die Länge der Liste list zurück.

Beispiele:

Ausdruck

Wert

len([1, 2, 3])

3

timedelta()

Gibt einen „leeren“ Zeitraum zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29) + timedelta()

@(2000-02-29)

timedelta(tage)

Gibt einen DATE-Wert von tage Tagen zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29) + timedelta(1)

@(2000-03-01)

@(2000-02-29) - timedelta(1)

@(2000-02-28)

timedelta(tage, sekunden)

Gibt einen DATETIME-Wert von tage Tagen und sekunden Sekunden zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29T12:34:56) + timedelta(1, 100)

@(2000-03-01T12:36:36)

monthdelta()

Gibt einen MONTHDELTA-Wert für 0 Monate zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29) + monthdelta()

@(2000-02-29)

monthdelta(n)

Gibt einen MONTHDELTA-Wert von n Monaten zurück.

Beispiele:

Ausdruck

Wert

@(2000-01-01) + monthdelta(1)

@(2000-02-01)

@(2000-01-31) + monthdelta(1)

@(2000-02-29)

years(n)

Gibt einen MONTHDELTA-Wert von n Jahren zurück.

Beispiele:

Ausdruck

Wert

@(2000-01-01) + years(1)

@(2001-01-01)

@(2000-02-29) + years(1)

@(2001-02-28)

months(n)

Gibt einen MONTHDELTA-Wert von n Monaten zurück.

Beispiele:

Ausdruck

Wert

@(2000-01-01) + monthdelta(1)

@(2000-02-01)

@(2000-01-31) + monthdelta(1)

@(2000-02-29)

days(n)

Gibt einen DATEDELTA-Wert von n Tagen zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29) + days(1)

@(2000-03-01)

@(2000-02-29) - days(1)

@(2000-02-28)

@(2000-01-31) + days(30)

@(2000-03-01)

@(2000-02-29) + days(89)

@(2000-05-28)

hours(n)

Gibt einen DATETIMEDELTA-Wert von n Stunden zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29T12:34:56) + hours(1)

@(2000-02-29T13:34:56)

minutes(n)

Gibt einen DATETIMEDELTA-Wert von n Minuten zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29T12:34:56) + minutes(1)

@(2000-02-29T13:35:56)

seconds(n)

Gibt einen DATETIMEDELTA-Wert von n Sekunden zurück.

Beispiele:

Ausdruck

Wert

@(2000-02-29T12:34:56) + seconds(1)

@(2000-02-29T13:34:57)

md5(s)

Gibt die MD5-Prüfsumme für den String s zurück.

Beispiele:

Ausdruck

Wert

md5("")

"d41d8cd98f00b204e9800998ecf8427e"

md5("gurk")

"4b5b6a3fa4af2541daa569277c7ff4c5"

random()

Gibt eine zufällige Zahl zwischen 0.0 (einschließlich) und 1.0 (ausschließlich) zurück.

randrange(start, stop)

Gibt eine zufällige ganze Zahl zwischen start (einschließlich) und stop (ausschließlich) zurück.

cos(x)

Gibt den Cosinus von x (im Bogenmaß) zurück.

sin(x)

Gibt den Sinus von x (im Bogenmaß) zurück.

tan(x)

Gibt den Tangens von x (im Bogenmaß) zurück.

sqrt(x)

Gibt den Quadratwurzel von x zurück.

abs(x)

Gibt der Absolutbetrag von x zurück.

geo(lat, long)

Gibt einen Geo-Wert mit dem Längengrad lat und dem Breitengrad long zurück. Das info-Atribut ist None.

geo(lat, long, info)

Gibt einen Geo-Wert mit dem Längengrad lat, dem Breitengrad long und der Beschreibung info zurück.

dist(x, y)

Gibt den Abstand zwischen den beiden Geo-Koordinaten x und y zurück.

request_id()

In der Filterbedingung für Datenquellen kann mittels request_id() auf die eindeutige ID des Requests zugegriffen werden.

request_method()

In der Filterbedingung für Datenquellen kann mittels request_method() auf die HTTP-Request-Methode zugegriffen werden.

request_url()

In der Filterbedingung für Datenquellen kann mittels request_url() auf die vollständige URL (mit Query-String) zugegriffen werden.

In der Filterbedingung für Datenquellen kann mittels request_param_*()-Funktionen auf die Parameter des HTTP-Requests zugegriffen werden (nur bei Anzeige-Templates, nicht bei E-Mail-Templates). Es gibt zehn request_param_*() Funktionen.

request_param_str(name)

Gibt die Parameter als Einzelwerte zurück und interpretiert sie als String. Wenn ein Parametername trotzdem doppelt angegeben wurde, ist es der Wert des ersten Auftretens, d.h. in der URL:

http://my.living-apps.de/gateway/apps/1234567890abcdef12345678?template=gurk&x[]=1&y=2&x[]=3

ergibt request_param_str("x") den String "1". Wurde der Parametername gar nicht angegeben, so ist der Wert None.

request_param_strlist(name)

Gibt die Parameter als Listen zurück und interpretiert sie als String, d.h. wenn ein Parametername mehrmals angegeben wurde, so ist der Wert eine Liste mit mehreren Strings, wurde er nur einmal angegeben, so enthält die Liste nur einen String, wurde der Parametername gar nicht angegeben, so ist die Liste leer. Bei obiger URL ergibt also request_param_strlist("x") die Liste ["1", "3"], request_param_strlist("y") ergibt ["2"] und request_param_strlist("z") ergibt [].

request_param_int(name)

Gibt die Parameter als Einzelwerte zurück und interpretiert sie als ganze Zahl. Wird ein Parametername trotzdem doppelt angegeben, ist es der Wert des ersten Auftretens, d.h. in der URL:

http://my.living-apps.de/gateway/apps/1234567890abcdef12345678?template=gurk&x[]=1&y=2&x[]=3

ergibt request_param_int("x") die ganze Zahl 1. Wurde der Parametername gar nicht angegeben, oder entspricht er nicht dem Format für INT-Parameter, so ist der Wert None.

request_param_intlist(name)

Gibt die Parameter als Listen zurück und interpretiert sie als ganze Zahl, d.h. wenn ein Parametername mehrmals angegeben wurde, so ist der Wert eine Liste mit mehreren ganzen Zahlen, wurde er nur einmal angegeben, so enthält die Liste nur eine ganze Zahl. Wurde der Parametername gar nicht angegeben oder entspricht er nicht dem Format für INT-Parameter, so ist die Liste leer. Bei obiger URL ergibt also request_param_intlist("x") die Liste [1, 3], request_param_intlist("y") ergibt [2] und request_param_intlist("z") ergibt [].

request_param_float(name)

Gibt die Parameter als Einzelwerte zurück und interpretiert sie als Zahl mit Nachkommastellen. Wird ein Parametername trotzdem doppelt angegeben, ist es der Wert des ersten Auftretens, d.h. in der URL:

http://my.living-apps.de/gateway/apps/1234567890abcdef12345678?template=gurk&x[]=1.1&y=2.2&x[]=3.3

ergibt request_param_float("x") die Zahl 1.1. Wurde der Parametername gar nicht angegeben, oder entspricht er nicht dem Format für NUMBER-Parameter, so ist der Wert None.

request_param_floatlist(name)

Gibt die Parameter als Listen zurück und interpretiert sie als Zahl mit Nachkommastellen, d.h. wenn ein Parametername mehrmals angegeben wurde, so ist der Wert eine Liste mit mehreren Zahlen, wurde er nur einmal angegeben, so enthält die Liste nur eine Zahl. Wurde der Parametername gar nicht angegeben oder entspricht er nicht dem Format für NUMBER-Parameter, so ist die Liste leer. Bei obiger URL ergibt also request_param_floatlist("x") die Liste [1.1, 3.3], request_param_floatlist("y") ergibt [2.2] und request_param_floatlist("z") ergibt [].

request_param_date(name)

Gibt die Parameter als Einzelwerte zurück und interpretiert sie als Datum. Wird ein Parametername trotzdem doppelt angegeben, ist es der Wert des ersten Auftretens, d.h. in der URL:

http://my.living-apps.de/gateway/apps/1234567890abcdef12345678?template=gurk&x[]=2018-05-01&y=2018-06-01&x[]=2018-07-01

ergibt request_param_date("x") das Datum 01.05.2018. Das Format für DATE-Parameter ist YYYY-MM-DD. Zum Beispiel kann mit request_param_date("datum") in der Filterbedingung der Datenquelle auf datum=2000-02-29 in der URL zugegriffen werden. Wurde der Parametername gar nicht angegeben, oder entspricht er nicht dem Format für DATE-Parameter, so ist der Wert None.

request_param_datelist(name)

Gibt die Parameter als Listen zurück und interpretiert sie als Datum, d.h. wenn ein Parametername mehrmals angegeben wurde, so ist der Wert eine Liste mit mehreren Daten, wurde er nur einmal angegeben, so enthält die Liste nur ein Datum. Wurde der Parametername gar nicht angegeben oder entspricht er nicht dem Format für DATE-Parameter, so ist die Liste leer. Bei obiger URL ergibt also request_param_datelist("x") die Liste [01.05.2018, 01.07.2018], request_param_datelist("y") ergibt [01.06.2018] und request_param_datelist("z") ergibt [].

request_param_datetime(name)

Gibt die Parameter als Einzelwerte zurück und interpretiert sie als Datum mit Uhrzeit. Wird ein Parametername trotzdem doppelt angegeben, ist es der Wert des ersten Auftretens, d.h. in der URL:

http://my.living-apps.de/gateway/apps/1234567890abcdef12345678?template=gurk&x[]=2018-05-01T14:30:55&y=2018-06-01T09:50:22&x[]=2018-07-01T12:30:05

ergibt request_param_datetime("x") das Datum mit Uhrzeit 01.05.2018 14:30:55. Das Format für DATETIME-Parameter ist YYYY-MM-DDTHH:MM:SS. Zum Beispiel kann mit request_param_datetime("datum") in der Filterbedingung der Datenquelle auf datum=2000-02-29T14:30:29 in der URL zugegriffen werden. Wurde der Parametername gar nicht angegeben oder entspricht er nicht dem Format für DATETIME-Parameter, so ist der Wert None.

request_param_datetimelist(name)

Gibt die Parameter als Listen zurück und interpretiert sie als Datum mit Uhrzeit, d.h. wenn ein Parametername mehrmals angegeben wurde, so ist der Wert eine Liste mit mehreren Daten und Uhrzeiten, wurde er nur einmal angegeben, so enthält die Liste nur ein Datum mit Uhrzeit. Wurde der Parametername gar nicht angegeben oder entspricht er nicht dem Format für DATETIME-Parameter, so ist die Liste leer. Bei obiger URL ergibt also request_param_datetimelist("x") die Liste [01.05.2018 14:30:55, 01.07.2018 12:30:05], request_param_datetimelist("y") ergibt [01.06.2018 09:50:22] und request_param_datetimelist("z") ergibt [].

In der Filterbedingung für Datenquellen kann mittels request_header_*()-Funktionen auf die Header des HTTP-Requests zugegriffen werden (nur bei Anzeige-Templates, nicht bei E-Mail-Templates). Es gibt zwei request_header_*() Funktionen.

request_header_str(name)

Gibt die Header als Einzelwerte zurück und interpretiert sie als String. Wenn ein Header mehrfach angegeben wurde, ist es der Wert des ersten Auftretens.

request_header_strlist(name)

Gibt die Header als Listen zurück und interpretiert sie als String, d.h. wenn ein Header mehrmals angegeben wurde, so ist der Wert eine Liste mit mehreren Strings, wurde er nur einmal angegeben, so enthält die Liste nur einen String, wurde der Header gar nicht angegeben, so ist die Liste leer.