Mescalero 3 - Funktionen

Like

Überprüft, ob eine Zeichenkette einer anderen Zeichenkette ähnlich ist. Dazu werden Wildcards "*" und "?" verwendet. "*" steht für ein beliebiges Zeichen, das beliebig oft vorkommen darf. "?" steht für ein Zeichen das genau einmal vorkommen muss. Für das Verwenden von Wildcards gelten folgende Einschränkungen:

Beliebig viele "?" und höchstens ein "*".
Ende und Anfang ein "*" und sonst keine Wildcards (weder "*" noch "?").

Mit dem letzten Parameter kann man angeben, ob zwischen Groß- und Kleinschreibung unterschieden werden soll.

Parameter

Zeichenkette
Wildcard-String
Groß/ Kleinschreibung

Beispiel

like("Mescalero", "*esc*") = 1
like("Mescalero", "*ESC*") = 0
like("Mescalero", "*ESC*", 0) = 1
like("Mescalero", "*le?o") = 1
like("Mescalero", "*ler?o") = 0
like("Mescalero", "ME*SCALERO", 0) = 1
like("Mescalero", "ME*E??", 0) = 1

equal

Überprüft, ob zwei Werte gleich sind. Wenn zwei Zeichenketten/ Strings verglichen werden, wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

erster Wert
zweiter Wert

Beispiel

equal(5,5) = 1
equal(5,6) = 0
equal(5.123,5.123) = 1
equal("Mescalero","mescalero") = 0

notequal

Überprüft, ob zwei Werte ungleich sind. Wenn zwei Zeichenketten/ Strings verglichen werden, wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

erster Wert
zweiter Wert

Beispiel

notequal(5,5) = 0
notequal(5,6) = 1
notequal(5.123,5.123) = 0
notequal("Mescalero","mescalero") = 1

greater

Überprüft, ob der erste Wert größer als der zweite Wert ist. Wenn zwei Zeichenketten/ Strings verglichen werden, wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

erster Wert
zweiter Wert

Beispiel

greater(5,5) = 0
greater(5,6) = 0
greater(5.123,5.123) = 0
greater("Mescalero","Apache") = 1

smaller

Überprüft, ob der erste Wert kleiner als der zweite Wert ist. Wenn zwei Zeichenketten/ Strings verglichen werden, wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

erster Wert
zweiter Wert

Beispiel

smaller(5,5) = 0
smaller(5,6) = 1
smaller(5.123,5.123) = 0
smaller("Mescalero","Apache") = 0

greaterequal

Überprüft, ob der erste Wert gleich wie oder größer als der zweite Wert ist. Wenn zwei Zeichenketten/ Strings verglichen werden, wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

erster Wert
zweiter Wert

Beispiel

greaterequal(5,5) = 1
greaterequal(5,6) = 0
greaterequal(5.123,5.123) = 1
greaterequal("Mescalero","Apache") = 1

smallerequal

Überprüft, ob der erste Wert gleich wie oder kleiner als der zweite Wert ist. Wenn zwei Zeichenketten/ Strings verglichen werden, wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

erster Wert
zweiter Wert

Beispiel

smallerequal(5,5) = 1
smallerequal(5,6) = 1
smallerequal(5.123,5.123) = 1
smallerequal("Mescalero","Apache") = 0

Starts

Überprüft, ob eine Zeichenkette mit einer bestimmten Zeichenkombination anfängt. Die Funktion unterscheidet zwischen Groß- und Kleinschreibung.

Parameter

Zeichenkette
zu überprüfender Start

Beispiel

starts("Mescalero", "Mesc") = 1
starts("Mescalero", "") = 1
starts("starts("Mescalero", "Apache") = 0
starts("Mescalero", "escalero") = 0
starts("Mescalero", "mesc") = 0

IsSubStr

Überprüft, ob eine Zeichenkette eine bestimmte Zeichenkette enthält. Die Funktion unterscheidet zwischen Groß- und Kleinschreibung.

Parameter

Zeichenkette
zu überprüfender Teil

Beispiel

isSubStr("Mescalero", "Mesc") = 1
isSubStr("Mescalero", "escalero") = 1
isSubStr("Mescalero", "") = 1
isSubStr("Mescalero", "Apache") = 0
isSubStr("Mescalero", "mesc") = 0

and

Überprüft, ob ALLE Parameter wahr sind.

Parameter

Wahrheitswerte

Beispiel

and(1,1,1) = 1
and(1,0,1) = 0
and(0,0,0) = 0
and(IsPage(),equal(code,404)) gibt gerade dann wahr (1) zurück, wenn die Anfrage an eine Seite ("IsPage()") gestellt wurde UND die Seite nicht gefunden wurde ("equal(code,404)").

or

Überprüft, ob mindestens ein Parameter wahr ist.

Parameter

Wahrheitswerte

Beispiel

or(1,1,1) = 1
or(1,0,1) = 1
or(0,0,0) = 0
or(IsPage(),IsDownload()) gibt gerade dann wahr (1) zurück, wenn die Anfrage an eine Seite ("IsPage()") ODER an einen Download gestellt wurde ("IsDownload()").

not

Überprüft, ob der Parameter nicht wahr ist.

Parameter

Wahrheitswert

Beispiel

not(1) = 0
not(0) = 1
not(IsPage()) gibt gerade dann wahr (1) zurück, wenn die Anfrage nicht an eine Seite ("IsPage()") gestellt wurde.

IsPage

Ermittelt, ob die aktuelle Anfrage an eine Seite gestellt wurde. Diese Funktion verwendet die Daten des Lookups "filetype".

IsDownload

Ermittelt, ob die aktuelle Anfrage an eine Datei des Typs Download gestellt wurde. Diese Funktion verwendet die Daten des Lookups "filetype".

IsGraphic

Ermittelt, ob die aktuelle Anfrage an eine Grafikdatei gestellt wurde. Diese Funktion verwendet die Daten des Lookups "filetype".

InVisit

Ermittelt ob der Ausdruck irgendwann (d.h. mindestens einmal) im kompletten Besuch wahr ist.

Parameter

Ausdruck

Beispiel

InVisit(IsPage()) = Wird in dem Besuch zu der die aktuelle Anfrage gehört mindestens einmal eine Seite abgerufen?
InVisit(equal(filename,"/software/download/mescalero.exe")) = Wird in dem Besuch zu der die aktuelle Anfrage gehört mindestens einmal Mescalero heruntergeladen?

IsLocal

Ermittelt ob der Referrer dieser Seite zu einer eigenen Domain gehört. Als eigene Domains zählen diese, die in den Projekteinstellungen angegeben wurden.

IsEnter

Gibt an, ob dies die erste Anfrage an eine Seite ist, die in einem Besuch abgerufen wurde. Falls die aktuelle Anfrage nicht an eine Seite gestellt wurde, wird -1 zurückgegeben.

IsExit

Gibt an, ob dies die letzte Anfrage an eine Seite ist, die in einem Besuch abgerufen wurde. Falls die aktuelle Anfrage nicht an eine Seite gestellt wurde, wird -1 zurückgegeben.

IsOneView

Gibt an, ob in dem Besuch, zu dem diese Anfrage gehört, insgesamt nur diese eine Seite abgerufen wurde. Falls die aktuelle Anfrage nicht an eine Seite gestellt wurde, wird -1 zurückgegeben.

Steps

Gibt an, wie viele Anfragen an Seiten in diesem Besuch vor dieser Anfrage gestellt wurden. Falls die aktuelle Anfrage nicht an eine Seite gestellt wurde, wird -1 zurückgegeben.

ViewTime

Berechnet die Zeit, die zwischen dem Abruf dieser Seite und der nächsten Seite im selben Besuch vergeht. Falls dies die letzte Seite in diesem Besuch ist, wird -1 zurückgegeben. Falls die aktuelle Anfrage nicht an eine Seite gestellt wurde, wird -1 zurückgegeben.

IsVisit

Ermittelt, ob die Anfrage zu einem (echten) Besuch gehört. Diese Funktion berücksichtigt die aktuellen Einstellungen des Projekts zur Besuchserkennung.

LocalTime

Berechnet die lokale Uhrzeit und das lokale Datum einer Anfrage. Diese Funktion berücksichtigt die aktuellen Einstellungen des Projekts zum Zeitunterschied zwischen Server und lokal.

ServerTime

Berechnet die Uhrzeit und das Datum einer Anfrage auf dem Server. Diese Funktion berücksichtigt die aktuellen Einstellungen des Projekts zum Zeitunterschied zwischen Server und lokal.

Beispiel

Es gilt ServerTime() = date

DownloadPage

Gibt den Dateinamen filename der Anfrage zurück, die zu der aktuellen Anfrage führte. Falls es keine solche Anfrage gibt, wird der leere String "" zurückgegeben.

Navig

Ermittelt einen Ausdruck auf einem anderen Feld. Dieses andere Feld ist an der Tabellenposition Datenfeldindex zu finden. So entspricht beispielsweise Navig(prevpage, filename) der Funktion DownloadPage(). Falls der Datenfeldindex über die Tabelle hinausgeht, wird für Ausdruck vom Typ String ein "" und für einen Ausdruck eines anderen Typs ein -1 zurückgegeben.

Parameter

Datenfeldindex
Ausdruck

Beispiel

Navig(prevpage, filename) = der Dateinamen der Seite, von der der Besucher auf die aktuelle Anfrage kam.
Navig(nextpage, filename) = der Dateinamen der Seite, die der Besucher nach der aktuellen Anfrage ansieht.
Navig(prevpage, LocalDate()) = das lokale Datum der Seite, von der der Besucher auf die aktuelle Anfrage kam.

VisitID

Gibt die ID des Besuchs zurück, zu der die aktuelle Anfrage gehört. Wichtig: Bei der Berichtserstellung bezieht sich die ID auf das komplette Projekt. Nach dem Hinzufügen von neuen Logfiles werden die IDs in allen Logfiles automatisch angepasst.

Add

Addiert Zahlen bzw. hängt einzelne Strings aneinander. Die Argumente müssen jeweils vom selben Typ sein.

Parameter

beliebig viele Argumente

Beispiel

add("Mesc", "al", "ero") = "Mescalero"
add(1, 5) = 6
add(1.5, 6, 5.5) = 13

filename

Extrahiert den Dateinamen aus dem String Datei. Als Trennzeichen wird der letzte Slash "/" oder Backslash "\" verwendet.

Parameter

Datei

Beispiel

filename("/software/download/mescalero.exe") = "mescalero.exe"
filename() = filename(filename)

filepath

Extrahiert den Dateipfad aus dem String Datei. Als Trennzeichen wird der letzte Slash "/" oder Backslash "\" verwendet.

Parameter

Datei

Beispiel

filepath("/software/download/mescalero.exe") = "/software/download/"
filepath() = filepath(filename)

fileext

Extrahiert die Dateierweiterung aus dem String Datei. Als Trennzeichen wird der letzte Punkt "." verwendet.

Parameter

Datei

Beispiel

fileext("/software/download/mescalero.exe") = ".exe"
fileext() = fileext(filename)

Domain

Extrahiert die Domain aus dem String URL.

Parameter

URL
Domainanfang behalten

Beispiel

Domain("http://www.rendle.de/software/mescalero.html", 1) = "www.rendle.de"
Domain("ftp://www.rendle.de/software/mescalero.html", 1) = "www.rendle.de"
Domain("http://www.rendle.de/software/mescalero.html") = "rendle.de"
Domain("http://shop.rendle.de/index.html") = "shop.rendle.de"
Domain("u1.g2.rendle.de") = "rendle.de"

IsDomain

Testet, ob es sich um eine gültige Domain handelt. Es werden keine Domains mit Umlauten oder sonstigen Sonderzeichen unterstützt.

Parameter

zu überprüfende Domain

Beispiel

IsDomain("www.rendle.de") = 1
IsDomain("www.rändlä.de") = 0
IsDomain("rendle") = 0
IsDomain("rendle.de") = 1
IsDomain("127.0.0.1") = 0

TLD

Extrahiert den letzten Teil einer Domain.

Parameter

Domain

Beispiel

TLD("www.rendle.de") = "de"
TLD("127.0.0.1") = "?"

QueryParam

Extrahiert einen Parameterwert aus einer Query. Für den Fall, dass der gesuchte Wert in mehreren Parametern sein könnte, kann man weitere Parameter angeben. Sobald einer der Parameter im Query-String gefunden wurde, wird abgebrochen. QueryParam unterscheidet zwischen Groß- und Kleinschreibung.

Parameter

Query
zu extrahierenden Parameter

Beispiel

QueryParam("sessionid=1&userid=4&password=test", "userid") = "4"
QueryParam("sessionid=1&userid=4&password=test", "password") = "test"
QueryParam("sessionid=1&userid=4&password=test", "userid", "password") = "4"
QueryParam("sessionid=1&userid=4&password=test", "abc") = ""
QueryParam("http://www.rendle.de/index.html?sessionid=1", "sessionid") = "1"

CookieParam

Extrahiert einen Parameterwert aus den Cookies. Für den Fall, dass der gesuchte Wert in mehreren Parametern sein könnte, kann man weitere Parameter angeben. Sobald einer der Parameter gefunden wurde, wird abgebrochen. CookieParam unterscheidet zwischen Groß- und Kleinschreibung.

Parameter

zu extrahierender Parameter

Beispiel

CookieParam("sessionid=1; userid=4", "userid") = "4"
CookieParam("sessionid=1; userid=4; password=test", "password") = "test"
CookieParam("sessionid=1; userid=4; password=test", "userid", "password") = "4"
CookieParam("sessionid=1; userid=4; password=test", "abc") = ""

NoQuery

Entfernt die Query aus einer URL.

Parameter

Beispiel

noquery("http://www.google.de/search?q=dies+ist+ein+test") = "dies+ist+ein+test"

DecodeQuery

Wandelt die Steuerzeichen in einer Query bzw. einem beliebigen String um.

Parameter

Query

Beispiel

decodeQuery("dies+ist%20ein&test") = "dies ist ein&test"

Substr

Extrahiert einen Teilstring aus einem String. Falls die Anzahl zu extrahierender Zeichen nicht angegeben wird, wird der Teilstring bis zum Ende zurückgegeben.

Parameter

Ausgangszeichenkette
Startposition
Anzahl an Zeichen

Beispiel

substring("Mescalero", 3) = "scalero"
substring("Mescalero", 3, 4) = "scal"
substring("Mescalero", 3, 100) = "scalero""
substring("Mescalero", 1) = "Mescalero"

Lowercase

Wandelt alle Zeichen eines Strings in Kleinbuchstaben um.

Parameter

Ausgangszeichenkette

Beispiel

lowercase("Mescalero") = "mescalero"

Uppercase

Wandelt alle Zeichen eines Strings in Großbuchstaben um.

Parameter

Ausgangszeichenkette

Beispiel

uppercase("Mescalero") = "MESCALERO"

datetime

Kodiert einen Zeitpunkt.

Parameter

Jahr
Monat
Tag
Stunden
Minuten
Sekunden

Beispiel

DateTime(2005,12,24,15,30,00) entspricht 15:30 Uhr und 0 Sekunden am 24. Dez 2005
DateTime(2005,12,24,15,31,20) entspricht 15:31 Uhr und 20 Sekunden am 24. Dez 2005

day

Gibt die Zeit mit der Genauigkeit des Tages zurück. Die Uhrzeit wird auf 00:00 Uhr gesetzt.

Parameter

Zeit

Beispiel

day(DateTime(2005,12,24,15,30,00)) = DateTime(2005,12,24,00,00,00)
day(DateTime(2005,12,24,15,31,20)) = DateTime(2005,12,24,00,00,00)

month

Gibt die Zeit mit der Genauigkeit des Monats zurück. Der Tag wird auf den ersten des Monats und die Uhrzeit wird auf 00:00 Uhr gesetzt.

Parameter

Zeit

Beispiel

month(DateTime(2005,12,24,15,30,00)) = DateTime(2005,12,1,00,00,00)
month(DateTime(2005,12,24,15,31,20)) = DateTime(2005,12,1,00,00,00)

year

Gibt die Zeit mit der Genauigkeit des Jahres zurück. Der Tag wird auf den ersten des Jahres und die Uhrzeit wird auf 00:00 Uhr gesetzt.

Parameter

Zeit

Beispiel

year(DateTime(2005,12,24,15,30,00)) = DateTime(2005,1,1,00,00,00)
year(DateTime(2005,12,24,15,31,20)) = DateTime(2005,1,1,00,00,00)

hourofday

Gibt die Stunden der Uhrzeit zurück.

Parameter

Zeit

Beispiel

year(DateTime(2005,12,24,15,30,00)) entspricht 15:00
year(DateTime(2005,12,25,15,31,20)) entspricht 15:00

hourofday

Gibt die Stunden der Zeit zurück.

Parameter

Zeit

Beispiel

year(DateTime(2005,12,24,15,30,00)) = 15
year(DateTime(2005,12,25,15,31,20)) = 15

dayofweek

Gibt den Wochentag zurück. 1 entspricht Montag und 7 entspricht Sonntag.

Parameter

Zeit

Beispiel

year(DateTime(2005,12,24,15,30,00)) = 6
year(DateTime(2005,12,25,15,31,20)) = 7

weekofyear

Gibt die Kalenderwoche zurück.

Parameter

Zeit

Beispiel

year(DateTime(2005,12,24,15,30,00)) = 51
year(DateTime(2005,12,26,15,31,20)) = 52

monthofyear

Gibt den Monat des Jahres zurück.

Parameter

Zeit

Beispiel

year(DateTime(2005,12,24,15,30,00)) = 12
year(DateTime(2005,12,26,15,31,20)) = 12

ifthenelse

Falls die Bedingung stimmt, wird der erste Wert zurückgegeben ansonsten der zweite.

Parameter

Bedingung
Wert 1
Wert 2

Beispiel

ifthenelse(greater(5,3),"5 ist größer als 3","3 ist größer als 5") = "5 ist größer als 3"