Funktionen

SketShDb stellt in Formelfeldern eine Anzahl von Funktionen zur Verfügung, die du zur Berechnung von Werten verwenden kannst.

Diese Seite listet die Funktionen sortiert nach ihrem Ergebnistyp auf:

Datum
TZI2Local(date:date), combineDateAndTime(date,time), combineDateAndTimeTZI(date,time), dateExpression(str), dateVal(date), dateadd(date,value:num,unit:str), dateaddTZI(date,value:num,unit:str), dateceil(date:date,unit:str,modulo:num?), dateceilTZI(date:date,unit:str,modulo:num?), datefloor(date:date,unit:str,modulo:num?), datefloorTZI(date:date,unit:str,modulo:num?), dateround(date:date,unit:str,modulo:num?), dateroundTZI(date:date,unit:str,modulo:num?), getProperty(alias,property), getValue(alias,property), getVariable(name:str), if(condition:bool,then:date,else:date), local2TZI(date:date), nil(), objectPathLiveDate(path:str), objectPathSearchableDate(path:str), value(date), whenNil(value:date,default:date)

Dokumenten-ID
docIdVal(docId), getDocumentId(alias), getProperty(alias,property), getValue(alias,property), getVariable(name:str), nil(), value(docId)

Farbe
color(hue:num,saturation:num,brightness:num,alpha:num), color(red:num,green:num,blue:num,alpha:num), colorVal(color), getProperty(alias,property), getValue(alias,property), getVariable(name:str), if(condition:bool,then:color,else:color), nil(), objectPathLiveColor(path:str), objectPathSearchableColor(path:str), value(color), whenNil(value:color,default:color)

Liste von Dokumenten-IDs
docIdArrayVal(docIdArray), getProperty(alias,property), getValue(alias,property), getVariable(name:str), nil(), toArray(documentId,documentId,...), value(docIdArray)

Liste von Texten
applyJsonPath(json:str,path:str), getProperty(alias,property), getValue(alias,property), getVariable(name:str), nil(), objectPathLiveStrArray(path:str), objectPathSearchableStrArray(path:str), split(str,separatorChars:str), strArrayVal(strArray), toArray(str,str,...), value(strArray)

Liste von Zahlen
getVariable(name:str), nil(), numArrayVal(numArray), objectPathLiveNumArray(path:str), objectPathSearchableNumArray(path:str), toArray(num,num,...), value(numArray)

Ort
getProperty(alias,property), getValue(alias,property), getVariable(name:str), location(latitude:num,longitude:num), locationVal(location), nil(), objectPathLiveLoc(path:str), objectPathSearchableLoc(path:str), value(location)

Schalter
!=(case-sensitive:bool,str,str), !=(date,date), !=(documentId,documentId), !=(num,num), !=(num,num,precision:num), !=(str,str), !=?(str,str), <(case-sensitive:bool,str,str), <(date,date), <(num,num), <(str,str), <=(case-sensitive:bool,str,str), <=(date,date), <=(num,num), <=(str,str), <=?(str,str), <?(str,str), ==(case-sensitive:bool,str,str), ==(date,date), ==(documentId,documentId), ==(num,num), ==(num,num,precision:num), ==(str,str), ==?(str,str), >(case-sensitive:bool,str,str), >(date,date), >(num,num), >(str,str), >=(case-sensitive:bool,str,str), >=(date,date), >=(num,num), >=(str,str), >=?(str,str), >?(str,str), and(bool,bool,...), boolVal(bool), getProperty(alias,property), getValue(alias,property), getVariable(name:str), hasLocationNotification(), hasScheduledNotification(), if(condition:bool,then:bool,else:bool), isAm(date), isAmTZI(date), isCurrentUserInAdminRole(), isCurrentUserInRole(role:str), isNil(value:bool), isNil(value:color), isNil(value:date), isNil(value:location), isNil(value:num), isNil(value:str), isNilOrEmpty(value:str), isPm(date), isPmTZI(date), matches(value:str,regex:str), nil(), not(bool), objectPathLiveBool(path:str), objectPathSearchableBool(path:str), or(bool,bool,...), toBool(value:num), value(bool), whenNil(value:bool,default:bool)

Text
caseInsensitiveMax(strArray), caseInsensitiveMin(strArray), caseSensitiveMax(strArray), caseSensitiveMin(strArray), char(value:num), city(location), concat(separator:str,str,str,...), concat(separator:str,strArray), concat(str,str,...), concat(strArray), country(location), diacriticFold(str), displayValueLive(property), displayValueSearchable(property), element(strArray,index:num), emitted(), first(strArray), getProperty(alias,property), getValue(alias,property), getVariable(name:str), if(condition:bool,then:str,else:str), isoCodeCountry(location), last(strArray), left(str,length:num), lower(str), max(case-sensitive:bool,str,str,...), min(case-sensitive:bool,str,str,...), nil(), objectPathLiveStr(path:str), objectPathSearchableStr(path:str), postalCode(location), replace(str,regex:str,replacement:str,global:bool), replace(str,substr:str,repl:str), right(str,length:num), stars(value:num,fillTo:num,with-halves:bool), strVal(str), street(location), stripNonAlphanum(str), substr(str,start:num,length:num), title(location), toString(value:num), toString(value:num,minIntegerDigits:num,minFractionDigits:num,maxFractionDigits:num,useGroupingSeparator:bool), toStringDate(value:date), toStringDateTZI(value:date), toStringDateTime(value:date,showSeconds:bool), toStringDateTimeTZI(value:date,showSeconds:bool), toStringTime(value:date,showSeconds:bool), toStringTimeTZI(value:date,showSeconds:bool), trim(str), upper(str), urldecode(str), urlencode(str), value(str), whenNil(value:str,default:str)

Zahl
*(num,num,...), *(numArray), +(num,num,...), +(numArray), -(num,num,...), /(num,num,...), abs(num), avg(num,num,...), avg(numArray), avgRating(), ceil(num), count(numArray), count(strArray), count(type,query?), datediff(from:date,until:date,unit:str), datediffTZI(from:date,until:date,unit:str), day(date), dayOfWeek(date), dayOfWeekTZI(date), dayOfYear(date), dayOfYearTZI(date), dayTZI(date), differenceOfDisLikes(), element(numArray,index:num), emitted(), first(numArray), floor(num), getProperty(alias,property), getValue(alias,property), getVariable(name:str), hour12(date), hour12TZI(date), hour24(date), hour24TZI(date), if(condition:bool,then:num,else:num), last(numArray), latitude(location), length(value:str), longtiude(location), max(num,num,...), max(numArray), maxRating(), min(num,num,...), min(numArray), minRating(), minute(date), minuteTZI(date), mod(num,num), month(date), monthTZI(date), neg(num), nil(), numVal(num), numberOfComments(), numberOfDislikes(), numberOfLikes(), numberOfRatings(), objectPathLiveNum(path:str), objectPathSearchableNum(path:str), pctLikes(), pi(), pow(num,num), rand(num), round(num), sig(num), sqrt(num), srand(num), toNumber(value:bool), toNumber(value:str), value(num), whenNil(value:num,default:num), year(date), yearTZI(date)

Datum

TZI2Local(date:date) -> time

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Ändert die Zeitzone des Datumswerts von UTC in die lokale Zeitzone, wobei sich die numerischen Werte nicht ändern, und gibt den resultierenden Datums/Zeitwert zurück. (aus 1.1.2000 13:15 Uhr UTC wird 1.1.2000 13:15 in der lokalen Zeitzone)

1"date"Datum Datums/Zeitwert

combineDateAndTime(date,time) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Bildet aus dem Datumsanteil eines Datums/Zeitwerts und dem Zeitanteil eines zweiten Datums/Zeitwerts einen neuen Datums/Zeitwert. (Werte verwenden die lokale Zeitzone.)

1"date"Datum Datums/Zeitwert, dessen Datumsanteil verwendet wird
2"time"Datum Datums/Zeitwert, dessen Zeitanteil verwendet wird

combineDateAndTimeTZI(date,time) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Bildet aus dem Datumsanteil eines Datums/Zeitwerts und dem Zeitanteil eines zweiten Datums/Zeitwerts einen neuen Datums/Zeitwert. (Werte verwenden die Zeitzone UTC)

1"date"Datum Datums/Zeitwert, dessen Datumsanteil verwendet wird
2"time"Datum Datums/Zeitwert, dessen Zeitanteil verwendet wird

dateExpression(str) -> date

Verwendbar in: Formelfelder,Ereignisse

Anmerkungen:

Rückgabewert(Datum)

Wertet den angegebenen Datumsausdruck aus und gibt den resultierenden Datums-/Zeitwert zurück. Datumsausdrücke können entweder feste Datums- oder Zeitangaben oder Zeitangaben relativ zur aktuellen Systemzeit sein. Weitere Informationen findest du hier.

1 Text Datumsausdruck: Entweder ein Datum im ISO-8601-Format oder ein Ausdruck wie z.B. "cd+12h". ("c" für "current" gefolgt von einer Zeiteinheit und beliebig vielen Ausdrücken der Form "+" oder "-"gefolgt von einer ganzen Zahl und einer Zeiteinheit. Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde)

dateVal(date) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf einen Datumswert festzulegen.)

1 Datum Datumswert

dateadd(date,value:num,unit:str) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Addiert eine Zeitspanne (eine bestimmte Anzahl von Zeiteinheiten, z.B. 2 Tage) zu einem Datum und gibt das Ergebnis zurück. (Datumswerte verwenden die jeweils lokale Zeitzone.)

1 Datum Datum, zu dem die Zeitspanne addiert wird
2"value"Zahl Anzahl der Zeiteinheiten
3"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde

dateaddTZI(date,value:num,unit:str) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Addiert eine Zeitspanne (eine bestimmte Anzahl von Zeiteinheiten, z.B. 2 Tage) zu einem Datum und gibt das Ergebnis zurück. (Datumswerte verwenden die Zeitzone UTC.)

1 Datum Datum, zu dem die Zeitspanne addiert wird
2"value"Zahl Anzahl der Zeiteinheiten
3"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde

dateceil(date:date,unit:str,modulo:num?) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Rundet ein Datum zur nächsten angegebenen Zeiteinheit (z.B. zum nächsten vollen Tag) auf und gibt das Ergebnis zurück. (Datumswerte verwenden die jeweils lokale Zeitzone.)

1"date"Datum Datum, das gerundet wird
2"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde, falls ein anderer Wert angegeben wird, wird die Einheit Tag verwendet.
3"modulo"Zahl,optional Es wird zum nächsten durch diesen Teiler teilbaren Wert aufgerundet

dateceilTZI(date:date,unit:str,modulo:num?) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Rundet ein Datum zur nächsten angegebenen Zeiteinheit (z.B. zum nächsten vollen Tag) auf und gibt das Ergebnis zurück. (Datumswerte verwenden die Zeitzone UTC.)

1"date"Datum Datum, das gerundet wird
2"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde, falls ein anderer Wert angegeben wird, wird die Einheit Tag verwendet.
3"modulo"Zahl,optional Es wird zum nächsten durch diesen Teiler teilbaren Wert aufgerundet

datefloor(date:date,unit:str,modulo:num?) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Rundet ein Datum zur nächsten angegebenen Zeiteinheit (z.B. zum nächsten vollen Tag) ab und gibt das Ergebnis zurück. (Datumswerte verwenden die jeweils lokale Zeitzone.)

1"date"Datum Datum, das gerundet wird
2"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde, falls ein anderer Wert angegeben wird, wird die Einheit Tag verwendet.
3"modulo"Zahl,optional Es wird zum nächsten durch diesen Teiler teilbaren Wert abgerundet

datefloorTZI(date:date,unit:str,modulo:num?) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Rundet ein Datum zur nächsten angegebenen Zeiteinheit (z.B. zum nächsten vollen Tag) ab und gibt das Ergebnis zurück. (Datumswerte verwenden die Zeitzone UTC.)

1"date"Datum Datum, das gerundet wird
2"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde, falls ein anderer Wert angegeben wird, wird die Einheit Tag verwendet.
3"modulo"Zahl,optional Es wird zum nächsten durch diesen Teiler teilbaren Wert abgerundet

dateround(date:date,unit:str,modulo:num?) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Rundet ein Datum zur nächsten angegebenen Zeiteinheit (z.B. zum nächsten vollen Tag) auf oder ab und gibt das Ergebnis zurück. (Datumswerte verwenden die jeweils lokale Zeitzone.)

1"date"Datum Datum, das gerundet wird
2"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde, falls ein anderer Wert angegeben wird, wird die Einheit Tag verwendet.
3"modulo"Zahl,optional Es wird zum nächsten durch diesen Teiler teilbaren Wert auf bzw. abgerundet

dateroundTZI(date:date,unit:str,modulo:num?) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Rundet ein Datum zur nächsten angegebenen Zeiteinheit (z.B. zum nächsten vollen Tag) auf oder ab und gibt das Ergebnis zurück. (Datumswerte verwenden die Zeitzone UTC.)

1"date"Datum Datum, das gerundet wird
2"unit (y/m/w/d/h/i/s)"Text Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde, falls ein anderer Wert angegeben wird, wird die Einheit Tag verwendet.
3"modulo"Zahl,optional Es wird zum nächsten durch diesen Teiler teilbaren Wert auf bzw. abgerundet

getProperty(alias,property) -> date

Verwendbar in: Ereignisse

Rückgabewert(Datum)

Gibt den Wert eines Datumsfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> date

Verwendbar in: Ereignisse

Rückgabewert(Datum)

Gibt den Wert eines Datumsfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> date

Verwendbar in: Ereignisse

Rückgabewert(Datum)

Gibt den Wert einer Variablen vom Typ "Datum/Zeit" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Datum/Zeit".

if(condition:bool,then:date,else:date) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Gibt einen von zwei Datumswerten zurück, je nachdem ob die Bedingung wahr oder falsch ist

1"condition"Schalter Bedingung
2"then"Datum Wert, der zurückgegeben wird, wenn die Bedingung zutrifft
3"else"Datum Wert, der zurückgegeben wird, wenn die Bedingung nicht zutrifft

local2TZI(date:date) -> time

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Ändert die Zeitzone des Datumswerts von der lokalen Zeitzone in die Zeitzone UTC, wobei sich die numerischen Werte nicht ändern, und gibt den resultierenden Datums/Zeitwert zurück. (aus 1.1.2000 13:15 Uhr lokaler Zeit wird 1.1.2000 13:15 UTC)

1"date"Datum Datums/Zeitwert

nil() -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen ein Datumswert erwartet wird. Keiner

objectPathLiveDate(path:str) -> date

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Datum)

Gibt den Datumswert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableDate(path:str) -> date

Verwendbar in: Formelfelder

Rückgabewert(Datum)

Gibt den Datumswert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

value(date) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Datum Datums-/Zeitwert

whenNil(value:date,default:date) -> date

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Datum)

Gibt den Wert des ersten Parameters zurück oder, falls dieser ungültig oder nicht gefüllt (NIL) ist, den Wert des zweiten Parameters.

1"value"Datum Wert, der zurückgegeben wird, falls er nicht NIL ist.
2"default"Datum Wert, der zurückgegeben wird, falls der erste Parameter NIL ist.

Dokumenten-ID

docIdVal(docId) -> docId

Verwendbar in: Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf eine Dokumenten-ID festzulegen.)

1 Dokumenten-ID Wert vom Typ Dokumenten-ID

getDocumentId(alias) -> documentId

Verwendbar in: Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt die DokumentenID eines im Speicher verfügbaren Dokuments zurück. Der Zugriff erfolgt über den vorhandenen Dokumenten-Alias. Damit ein Dokument eine Dokumenten-ID hat, muss das Dokument aus der Datenbank geladen oder zuvor schon einmal gespeichert gewesen sein.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.

getProperty(alias,property) -> documentId

Verwendbar in: Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt den Wert eines Eins-zu-Eins Referenzfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> documentId

Verwendbar in: Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt den Wert eines Eins-zu-Eins Referenzfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> documentId

Verwendbar in: Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt den Wert einer Variablen vom Typ "Dokumenten-ID" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Dokumenten-ID".

nil() -> docId

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen eine Dokumentreferenz erwartet wird. Keiner

value(docId) -> docId

Verwendbar in: Ereignisse

Rückgabewert(Dokumenten-ID)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Dokumenten-ID Wert vom Typ Dockumenten-ID

Farbe

color(hue:num,saturation:num,brightness:num,alpha:num) -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Erzeugt aus 4 Werten (Hue, Saturation, Brightness und Alpha) einen Farbwert und gibt diesen zurück. Werte außerhalb der Wertbereiche führen zur Rückgabe von NIL.

1"hue (0-360)"Zahl Hue-Wert in Grad (als Zahl von 0 bis 360)
2"saturation (0-100)"Zahl Saturation (Sättingungs)-Wert in Prozent (als Zahl von 0 bis 255)
3"brightness (0-100)"Zahl Brightness-Wert (als Zahl von 0 bis 255)
4"alpha (0-100)"Zahl Alpha-Wert (als Zahl von 0 bis 255)

color(red:num,green:num,blue:num,alpha:num) -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Erzeugt einen Farbwert aus 4 Werten (Rot, Grün, Blau, Alpha)) und gibt diesen zurück. Werte außerhalb der Wertbereiche führen zur Rückgabe von NIL.

1"red (0-255)"Zahl Rot-Wert (als Zahl von 0 bis 255)
2"green (0-255)"Zahl Grün-Wert (als Zahl von 0 bis 255)
3"blue (0-255)"Zahl Blau-Wert (als Zahl von 0 bis 255)
4"alpha (0-255)"Zahl Alpha-Wert (als Zahl von 0 bis 255)

colorVal(color) -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf einen Farbwert festzulegen.)

1 Farbe Farbwert

getProperty(alias,property) -> color

Verwendbar in: Ereignisse

Rückgabewert(Farbe)

Gibt den Wert eines Farbfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> color

Verwendbar in: Ereignisse

Rückgabewert(Farbe)

Gibt den Wert eines Farbfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> color

Verwendbar in: Ereignisse

Rückgabewert(Farbe)

Gibt den Wert einer Variablen vom Typ "Farbe" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Farbe".

if(condition:bool,then:color,else:color) -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Gibt einen von zwei Farbwerten zurück, je nachdem ob die Bedingung wahr oder falsch ist

1"condition"Schalter Wert, der zurückgegeben wird, wenn die Bedingung zutrifft
2"then"Farbe
3"else"Farbe Wert, der zurückgegeben wird, wenn die Bedingung nicht zutrifft

nil() -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen ein Farbwert erwartet wird. Keiner

objectPathLiveColor(path:str) -> color

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Farbe)

Gibt den Farbwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableColor(path:str) -> color

Verwendbar in: Formelfelder

Rückgabewert(Farbe)

Gibt den Farbwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

value(color) -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Farbe Farbwert

whenNil(value:color,default:color) -> color

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Farbe)

Gibt den Wert des ersten Parameters zurück oder, falls dieser ungültig oder nicht gefüllt (NIL) ist, den Wert des zweiten Parameters.

1"value"Farbe Wert, der zurückgegeben wird, falls er nicht NIL ist.
2"default"Farbe Wert, der zurückgegeben wird, falls der erste Parameter NIL ist.

Liste von Dokumenten-IDs

docIdArrayVal(docIdArray) -> docIdArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf eine Liste von Dokumenten-IDs festzulegen.)

1 Liste von Dokumenten-IDs Wert vom Typ Liste von Dokumenten-IDs

getProperty(alias,property) -> documentIdArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Gibt den Wert eines Eins-zu-Viele Referenzfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> documentIdArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Gibt den Wert eines Eins-zu-Viele Referenzfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> documentIdArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Gibt den Wert einer Variablen vom Typ "Liste von Dokumenten-IDs" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Liste von Dokumenten-IDs".

nil() -> docIdArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen eine Liste von Dokumentreferenzen erwartet wird. Keiner

toArray(documentId,documentId,...) -> documentId

Verwendbar in: Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Fügt eine Reihe von Texten in eine Liste von Texten zusammen.

1 Dokumenten-ID,0-* Beliebige Anzahl von Textparametern

value(docIdArray) -> docIdArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Dokumenten-IDs)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Liste von Dokumenten-IDs Wert vom Typ Liste von Dockumenten-IDs

Liste von Texten

applyJsonPath(json:str,path:str) -> strArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Texten)

Wertet den übergebenen JSON-String entsprechend des angegebenen JSONPath-Ausdrucks aus und gibt das Ergebnis als Liste zurück. String-Werte werden dabei ohne umschließende Anführungszeichen zurückgegeben, alle anderen Werte in JSON-Notation. Es wird immer eine Liste von Strings zurückgegeben, da ein JSONPath-Ausdruck generell mehrere Ergebnisse ergeben kann. ACHTUNG: Diese Funktionalität ist experimentell und es kann nicht garantiert werden, dass alle Arten von JSONPath-Ausdrücken auf allen Geräten funktionieren!

1"json"Text JSON-String des Dokuments
2"path"Text JSON-Path-Ausdruck

getProperty(alias,property) -> strArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Texten)

Gibt den Wert eines Mehrfachauswahlfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> strArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Texten)

Gibt den Wert eines Mehrfachauswahlfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> strArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Texten)

Gibt den Wert einer Variablen vom Typ "Liste von Texten" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Liste von Texten".

nil() -> strArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Texten)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen eine Liste von Textwerten erwartet wird. Keiner

objectPathLiveStrArray(path:str) -> strArray

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Liste von Texten)

Gibt den Textlistenwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableStrArray(path:str) -> strArray

Verwendbar in: Formelfelder

Rückgabewert(Liste von Texten)

Gibt den Textlistenwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

split(str,separatorChars:str) -> strArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Texten)

Teilt einen Text anhand der übergebenen Trennzeichen in eine Liste von Texten auf und gibt die Liste zurück.

1 Text Text, der zerteilt werden soll
2"separatorChars"Text Trennzeichen. Es wird jedes der Zeichen einzeln als Trenner angesehen, nicht der gesamte Textstring zusammen.

strArrayVal(strArray) -> strArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Texten)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf eine Liste von Texten festzulegen.)

1 Liste von Texten Wert vom Typ Liste von Texten

toArray(str,str,...) -> strArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Texten)

Liste, die aus den übergebenen Einzelwerten besteht. (ab Version 1.0.3)

1 Text,0-* Einzelwerte

value(strArray) -> strArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Texten)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Liste von Texten Wert vom Typ Liste von Textwerten

Liste von Zahlen

getVariable(name:str) -> numArray

Verwendbar in: Ereignisse

Rückgabewert(Liste von Zahlen)

Gibt den Wert einer Variablen vom Typ "Liste von Zahlen" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Liste von Zahlen".

nil() -> numArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Zahlen)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen eine Liste von Zahlenwerten erwartet wird. Keiner

numArrayVal(numArray) -> numArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Zahlen)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf eine Liste von Zahlenwerten festzulegen.)

1 Liste von Zahlen Wert vom Typ Liste von Zahlenwerten

objectPathLiveNumArray(path:str) -> numArray

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Liste von Zahlen)

Gibt den Zahlenlistenwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableNumArray(path:str) -> numArray

Verwendbar in: Formelfelder

Rückgabewert(Liste von Zahlen)

Gibt den Zahlenlistenwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

toArray(num,num,...) -> numArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Zahlen)

Liste, die aus den übergebenen Einzelwerten besteht. (ab Version 1.0.3)

1 Zahl,0-* Einzelwerte

value(numArray) -> numArray

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Liste von Zahlen)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Liste von Zahlen Wert vom Typ Liste von Zahlenwerten

Ort

getProperty(alias,property) -> location

Verwendbar in: Ereignisse

Rückgabewert(Ort)

Gibt den Wert eines Ortsfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> location

Verwendbar in: Ereignisse

Rückgabewert(Ort)

Gibt den Wert eines Ortsfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> location

Verwendbar in: Ereignisse

Rückgabewert(Ort)

Gibt den Wert einer Variablen vom Typ "Ort" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Ort".

location(latitude:num,longitude:num) -> location

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Ort)

Erzeugt einen Ortswert aus Längen- und Breitengrad

1"latitude"Zahl Breitengrad
2"longitude"Zahl Längengrad

locationVal(location) -> location

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Ort)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf einen Ortswert festzulegen.)

1 Ort Ortswert

nil() -> location

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Ort)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen ein Ortswert erwartet wird. Keiner

objectPathLiveLoc(path:str) -> location

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Ort)

Gibt den Ortswert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableLoc(path:str) -> location

Verwendbar in: Formelfelder

Rückgabewert(Ort)

Gibt den Ortswert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

value(location) -> location

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Ort)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Ort Ortswert

Schalter

!=(case-sensitive:bool,str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die beiden übergebenen Texte nicht gleich sind, ansonsten "falsch".

1"case-sensitive"Schalter Gibt an, ob beim Vergleich Groß-/Kleinschreibung berücksichtigt werden soll.
2 Text,2 2 Texte, die miteinander verglichen werden sollen

!=(date,date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die beiden übergebenen Datumswerte nicht gleich sind, ansonsten "falsch".

1 Datum,2 2 Datumswerte, die miteinander verglichen werden sollen

!=(documentId,documentId) -> bool

Verwendbar in: Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls beide Dokumenten-IDs nicht gleich sind.

1 Dokumenten-ID,2 2 Dokumenten-IDs

!=(num,num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die beiden übergebenen Zahlenwerte nicht gleich sind, ansonsten "falsch". (Es kann sein, dass ein Zahlenvergleich von Fließkommazahlen nicht das erwartete Ergebnis ergibt, insbesondere, wenn die Zahlen im Exponenten sehr weit voneinander entfernt liegen. Siehe nächste Funktion)

1 Zahl,2 2 Zahlenwerte, die miteinander verglichen werden

!=(num,num,precision:num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die beiden übergebenen Zahlenwerte nicht gleich sind, ansonsten "falsch".

1 Zahl,2 2 Zahlenwerte, die miteinander verglichen werden
2"precision"Zahl Gibt an, bis auf wie viele Nachkommastellen gerundet verglichen werden soll. (0 -> Zwei Zahlen sind gleich, wenn sie gerundet auf eine ganze Zahl gleich sind, 1 -> Zwei Zahlen sind gleich wenn sie gerundet auf eine Nachkommastelle gleich sind, usw.)

!=(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die beiden übergebenen Texte nicht gleich sind, ansonsten "falsch", wobei der Vergleich case-sensitive ist, also Groß-Kleinschreibung beachtet wird.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

!=?(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die beiden übergebenen Texte nicht gleich sind, ansonsten "falsch", wobei der Vergleich case-insensitive ist, also Groß-Kleinschreibung ignoriert.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

<(case-sensitive:bool,str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung vor dem zweiten Text einzuordnen ist, ansonsten "falsch".

1"case-sensitive"Schalter Gibt an, ob beim Vergleich Groß-/Kleinschreibung berücksichtigt werden soll.
2 Text,2 2 Texte, die miteinander verglichen werden sollen

<(date,date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls das erste angegebene Datum zeitlich vor dem zweiten angegebenen Datum liegt, ansonsten "falsch".

1 Datum,2 2 Datumswerte, die miteinander verglichen werden sollen

<(num,num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die erste angegebene Zahl kleiner als die zweite Zahl ist, ansonsten "falsch".

1 Zahl,2 2 numerische Werte, die miteinander verglichen werden sollen

<(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung vor dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-sensitive ist, also Groß-Kleinschreibung beachtet wird.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

<=(case-sensitive:bool,str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung vor oder gleich dem zweiten Text einzuordnen ist, ansonsten "falsch".

1"case-sensitive"Schalter Gibt an, ob beim Vergleich Groß-/Kleinschreibung berücksichtigt werden soll.
2 Text,2 2 Texte, die miteinander verglichen werden sollen

<=(date,date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls das erste angegebene Datum zeitlich vor oder zeitgleich mit dem zweiten Datumswert einzuordnen ist, ansonsten "falsch".

1 Datum,2 2 Datumswerte, die miteinander verglichen werden sollen

<=(num,num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die erste angegebene Zahl kleiner oder gleich der zweiten Zahl ist, ansonsten "falsch".

1 Zahl,2 2 numerische Werte, die miteinander verglichen werden sollen

<=(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung vor oder gleich dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-sensitive ist, also Groß-Kleinschreibung beachtet wird.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

<=?(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung vor oder gleich dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-insensitive ist, also Groß-Kleinschreibung ignoriert.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

<?(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung vor dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-insensitive ist, also Groß-Kleinschreibung ignoriert.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

==(case-sensitive:bool,str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text gleich dem zweiten Text ist, ansonsten "falsch".

1"case-sensitive"Schalter Gibt an, ob beim Vergleich Groß-/Kleinschreibung berücksichtigt werden soll.
2 Text,2 2 Texte, die miteinander verglichen werden sollen

==(date,date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls das erste Datum gleich dem zweiten Datum ist, ansonsten "falsch".

1 Datum,2 2 Datumswerte, die miteinander verglichen werden sollen

==(documentId,documentId) -> bool

Verwendbar in: Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls beide Dokumenten-IDs gleich sind.

1 Dokumenten-ID,2 2 Dokumenten-IDs

==(num,num)

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die erste Zahl gleich der zweiten Zahl ist, ansonsten "falsch". (Es kann sein, dass ein Zahlenvergleich von Fließkommazahlen nicht das erwartete Ergebnis ergibt, insbesondere, wenn die Zahlen im Exponenten sehr weit voneinander entfernt liegen. Siehe nächste Funktion)

1 Zahl,2 2 Zahlenwerte, die miteinander verglichen werden sollen

==(num,num,precision:num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die erste Zahl gleich der zweiten Zahl ist, ansonsten "falsch".

1 Zahl,2 2 Zahlenwerte, die miteinander verglichen werden sollen
2"precision"Zahl Gibt an, bis auf wie viele Nachkommastellen gerundet verglichen werden soll. (0 -> Zwei Zahlen sind gleich, wenn sie gerundet auf eine ganze Zahl gleich sind, 1 -> Zwei Zahlen sind gleich wenn sie gerundet auf eine Nachkommastelle gleich sind, usw.)

==(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text gleich dem zweiten Text ist, ansonsten "falsch", wobei der Vergleich case-sensitive ist, also Groß-Kleinschreibung beachtet wird.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

==?(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text gleich dem zweiten Text ist, ansonsten "falsch", wobei der Vergleich case-insensitive ist, also Groß-Kleinschreibung ignoriert.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

>(case-sensitive:bool,str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung nach dem zweiten Text einzuordnen ist, ansonsten "falsch".

1"case-sensitive"Schalter Gibt an, ob beim Vergleich Groß-/Kleinschreibung berücksichtigt werden soll.
2 Text,2 2 Texte, die miteinander verglichen werden sollen

>(date,date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls das erste angegebene Datum zeitlich nach dem zweiten angegebenen Datum liegt, ansonsten "falsch".

1 Datum,2 2 Datumswerte, die miteinander verglichen werden sollen

>(num,num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die erste angegebene Zahl größer als die zweite Zahl ist, ansonsten "falsch".

1 Zahl,2 2 numerische Werte, die miteinander verglichen werden sollen

>(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung nach dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-sensitive ist, also Groß-Kleinschreibung beachtet wird.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

>=(case-sensitive:bool,str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung nach oder gleich dem zweiten Text einzuordnen ist, ansonsten "falsch".

1"case-sensitive"Schalter Gibt an, ob beim Vergleich Groß-/Kleinschreibung berücksichtigt werden soll.
2 Text,2 2 Texte, die miteinander verglichen werden sollen

>=(date,date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls das erste angegebene Datum zeitlich vor oder zeitgleich mit dem zweiten Datumswert einzuordnen ist, ansonsten "falsch".

1 Datum,2 2 Datumswerte, die miteinander verglichen werden sollen

>=(num,num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls die erste angegebene Zahl kleiner oder gleich der zweiten Zahl ist, ansonsten "falsch".

1 Zahl,2 2 numerische Werte, die miteinander verglichen werden sollen

>=(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung nach oder gleich dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-sensitive ist, also Groß-Kleinschreibung beachtet wird.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

>=?(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung nach oder gleich dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-insensitive ist, also Groß-Kleinschreibung ignoriert.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

>?(str,str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, falls der erste Text bei alphabetischer Sortierung nach dem zweiten Text einzuordnen ist, ansonsten "falsch", wobei der Vergleich case-insensitive ist, also Groß-Kleinschreibung ignoriert.

1 Text,2 2 Texte, die miteinander verglichen werden sollen

and(bool,bool,...) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück wenn alle angegebenen Ausdrücke oder Werte "wahr" sind, ansonten "falsch".

1 Schalter,2-* Mindestens 2 Wahrheitsausdrücke oder -werte.

boolVal(bool) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf einen Wahrheitswert festzulegen.)

1 Schalter Wahrheitswert

getProperty(alias,property) -> bool

Verwendbar in: Ereignisse

Rückgabewert(Schalter)

Gibt den Wert eines Wahrheits- (= Schalter-)Feldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> bool

Verwendbar in: Ereignisse

Rückgabewert(Schalter)

Gibt den Wert eines Wahrheits- (= Schalter-)Feldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> bool

Verwendbar in: Ereignisse

Rückgabewert(Schalter)

Gibt den Wert einer Variablen vom Typ "Schalter (boolescher Wert)" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Schalter (boolescher Wert)".

hasLocationNotification() -> bool

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn für das aktuelle Dokument/den aktuellen Datensatz eine Orstbenachrichtigung aktiv ist, ansonsten "falsch". Keiner

hasScheduledNotification() -> bool

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn für das aktuelle Dokument/den aktuellen Datensatz eine Terminbenachrichtigung aktiv ist, ansonsten "falsch". Keiner

if(condition:bool,then:bool,else:bool) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt einen von zwei Wahrheitswerten zurück, je nachdem ob die Bedingung wahr oder falsch ist

1"condition"Schalter Bedingung
2"then"Schalter Wert, der zurückgegeben wird, wenn die Bedingung zutrifft
3"else"Schalter Wert, der zurückgegeben wird, wenn die Bedingung nicht zutrifft

isAm(date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn die Uhrzeit des übergebenen Datums/Zeitwertes vormittags liegt, also die Stunde < 12 ist, ansonsten "falsch". (in der jeweils lokalen Zeitzone)

1 Datum Zu prüfender Datumswert

isAmTZI(date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn die Uhrzeit des übergebenen Datums/Zeitwertes vormittags liegt, also die Stunde < 12 ist, ansonsten "falsch". (in der Zeitzone UTC)

1 Datum Zu prüfender Datumswert

isCurrentUserInAdminRole() -> bool

Verwendbar in: Formelfelder,Ereignisse

Anmerkungen:

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der jeweils aktuelle Benutzer der App für das aktuelle Projekt Administrationsrechte besitzt. Dies ist der Fall, wenn der Benutzer entweder Eigentümer/Ersteller der Datenbank ist oder eine ihm zugewiesene Rolle die Eigenschaft "Admin" hat. Keiner

isCurrentUserInRole(role:str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Anmerkungen:

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der jeweils aktuelle Benutzer der App die angegebene Datenbankrolle zugewiesen bekommen hat

1"role"Text Name der Rolle

isNil(value:bool) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene Wahrheitswert nicht definiert bzw. ungültig (NIL) ist, ansonsten "falsch".

1"value"Schalter Zu prüfender Wahrheitswert

isNil(value:color) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene Farbwert nicht definiert bzw. ungültig (NIL) ist, ansonsten "falsch".

1"value"Farbe Zu prüfender Farbwert

isNil(value:date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene Datumswert nicht definiert bzw. ungültig (NIL) ist, ansonsten "falsch".

1"value"Datum Zu prüfender Datumswert

isNil(value:location) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene Ortswert nicht definiert bzw. ungültig (NIL) ist, ansonsten "falsch".

1"value"Ort Zu prüfender Ortswert

isNil(value:num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene numerische Wert nicht definiert bzw. ungültig (NIL) ist, ansonsten "falsch".

1"value"Zahl Zu prüfender Zahlenwert

isNil(value:str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene Textwert nicht definiert bzw. ungültig (NIL) ist, ansonsten "falsch".

1"value"Text Zu prüfender Textwert

isNilOrEmpty(value:str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn der übergebene Textwert nicht definiert bzw. ungültig (NIL) oder leer ist, ansonsten "falsch".

1"value"Text Zu prüfender Textwert

isPm(date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn die Uhrzeit des übergebenen Datums/Zeitwertes nachmittags liegt, also die Stunde >= 12 ist, ansonsten "falsch". (in der jeweils lokalen Zeitzone)

1 Datum Zu prüfender Datumswert

isPmTZI(date) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück, wenn die Uhrzeit des übergebenen Datums/Zeitwertes nachmittags liegt, also die Stunde >= 12 ist, ansonsten "falsch". (in der Zeitzone UTC)

1 Datum Zu prüfender Datumswert

matches(value:str,regex:str) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt wahr zurück, wenn der übergebene reguläre Ausdruck im übergebenen Ausgangstext mindestens einen Treffer hat.

1"value"Text Ausgangstext
2"regex"Text Regulärer Ausdruck

nil() -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen ein Wahrheitswert erwartet wird. Keiner

not(bool) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Kehrt den übergebenen Wahrheitswert um.

1 Schalter Wahrheitswert

objectPathLiveBool(path:str) -> bool

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Schalter)

Gibt den Wahrheitswert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableBool(path:str) -> bool

Verwendbar in: Formelfelder

Rückgabewert(Schalter)

Gibt den Wahrheitswert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

or(bool,bool,...) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt "wahr" zurück wenn mindestens einer der angegebenen Ausdrücke oder Werte "wahr" ist, ansonsten "falsch".

1 Schalter,2-* Mindestens 2 Wahrheitsausdrücke oder -werte.

toBool(value:num) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Wandelt den übergebenen Zahlenwert in einen Wahrheitswert und gibt den Wahrheitswert zurück. Als "wahr" werden alle Zahlenwerte betrachtet, deren auf ganze Zahlen gerundeter Betrag größer oder gleich 1 ist.

1"value"Zahl Zahlenwert

value(bool) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Schalter Wahrheitswert

whenNil(value:bool,default:bool) -> bool

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Schalter)

Gibt den Wert des ersten Parameters zurück oder, falls dieser ungültig oder nicht gefüllt (NIL) ist, den Wert des zweiten Parameters.

1"value"Schalter Wert, der zurückgegeben wird, falls er nicht NIL ist.
2"default"Schalter Wert, der zurückgegeben wird, falls der erste Parameter NIL ist.

Text

caseInsensitiveMax(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt den nach alphabetischer (ohne Berücksichtigung von Groß-/Kleinschreibung) Sortierung letzten Wert der übergebenen Liste zurück.

1 Liste von Texten Liste von Textwerten

caseInsensitiveMin(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt den nach alphabetischer (ohne Berücksichtigung von Groß-/Kleinschreibung) Sortierung ersten Wert der übergebenen Liste zurück.

1 Liste von Texten Liste von Textwerten

caseSensitiveMax(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt den nach alphabetischer (mit Berücksichtigung von Groß-/Kleinschreibung) Sortierung letzten Wert der übergebenen Liste zurück.

1 Liste von Texten Liste von Textwerten

caseSensitiveMin(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt den nach alphabetischer (mit Berücksichtigung von Groß-/Kleinschreibung) Sortierung ersten Wert der übergebenen Liste zurück.

1 Liste von Texten Liste von Textwerten

char(value:num) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt das Zeichen zurück, dass in Unicode dem übergebenen Zahlenwert entspricht.

1"value"Zahl

city(location) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Namen der Stadt der Adresse eines Ortswerteszurück.

1 Ort Ortswert

concat(separator:str,str,str,...) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Konkateniert die übergebenen Texte getrennt durch den übergebenen Trenner und gibt das Ergebnis zurück.

1"separator"Text Trenner (ein oder mehrere Zeichen)
2 Text,1-* 2 oder mehr Texte, die zusammengefügt werden sollen

concat(separator:str,strArray) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Konkateniert die übergebene Liste von Texten getrennt durch den übergebenen Trenner und gibt das Ergebnis zurück. Wenn eine leere Liste übergeben wird, dann gibt die Funktion einen leeren Text zurück.

1"separator"Text Trenner (ein oder mehrere Zeichen)
2 Liste von Texten Liste von Texten, die zusammengefügt werden sollen

concat(str,str,...) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Konkateniert die übergebenen Texte und gibt das Ergebnis zurück.

1 Text,1-* 2 oder mehr Texte, die zusammengefügt werden sollen

concat(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Konkateniert die übergebene Liste von Texten und gibt das Ergebnis zurück.

1 Liste von Texten Liste von Texten, die zusammengefügt werden sollen

country(location) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt das Land aus der Adresse eines Ortswertes zurück

1 Ort Ortswert

diacriticFold(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Ersetzt diakritische Zeichen (in der deutschen Sprache z.B. Umlaute) durch deren "normales" Pendant und gibt den erzeugten Text zurück

1"value"Text Ursprungstext

displayValueLive(property) -> str

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Text)

Gibt einen Textwert für ein Feld eines beliebigen Typs aus. Es werden dabei die Standard-Formatierungsregeln des Feldes verwendet. (wird bei Verwendung im Dokument nicht im Dokument abgespeichert und bei der Anzeige ausgewertet)

1"property"Feld Eigenschaft des entsprechenden Typs

displayValueSearchable(property) -> str

Verwendbar in: Formelfelder

Rückgabewert(Text)

Gibt einen Textwert für ein Feld eines beliebigen Typs aus. Es werden dabei die Standard-Formatierungsregeln des Feldes verwendet. (wird im Dokument gespeichert und nur beim Speichern des Dokuments ausgewertet)

1"property"Feld Eigenschaft des entsprechenden Typs

element(strArray,index:num) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt das Element an der übergebenen Stelle der Liste zurück oder NIL, falls die angegebene Stelle in der Liste nicht existiert.

1 Liste von Texten List von Texten
2"index (0-(n-1))"Zahl Index der Stelle innerhalb der Liste (0-basiert: die 1. Stelle hat den Index 0)

emitted() -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt bei Verwendung von Sortierkriterien mit Mehrfachausgabe den für den jeweiligen Datensatz ausgegebenen Wert zurück. (Beispiel: Wenn das Feld der Mehrfachausgabe drei Werte "Wert1", "Wert2" und "Wert3" enthält, dann werden in der Liste 3 Einträge ausgegeben. Die emitted()-Funktion gibt dann jeweils für einen der Datensätze den Wert "Wert1", "Wert2" bzw. "Wert3" zurück.)
Gilt nur für Ansichten und Export, in Formularen ist der Wert leer. (ab Version 1.0.3) Keiner

first(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt das erste Element aus der Liste zurück oder NIL, falls die Liste keine Elemente hat.

1 Liste von Texten Liste von Texten

getProperty(alias,property) -> str

Verwendbar in: Ereignisse

Rückgabewert(Text)

Gibt den Wert eines Textfelds eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> str

Verwendbar in: Ereignisse

Rückgabewert(Text)

Gibt den Wert eines Textfelds eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> str

Verwendbar in: Ereignisse

Rückgabewert(Text)

Gibt den Wert einer Variablen vom Typ "Text" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Text".

if(condition:bool,then:str,else:str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt einen von zwei Textwerten zurück, je nachdem ob die Bedingung wahr oder falsch ist

1"condition"Schalter Bedingung
2"then"Text Wert, der zurückgegeben wird, wenn die Bedingung zutrifft
3"else"Text Wert, der zurückgegeben wird, wenn die Bedingung nicht zutrifft

isoCodeCountry(location) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den ISO-Code des Landes einer Adresse aus einem Ortswert zurück.

1 Ort Ortswert

last(strArray) -> str

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Text)

Gibt den letzten Wert der Liste von Texten zurück oder NIL, falls die Liste keine Einträge hat.

1 Liste von Texten Liste von Texten

left(str,length:num) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Teiltext einer bestimmte Länge vom Anfang des übergebenen Textes zurück. Gibt den gesamten Text zurück, falls er weniger als die angegebene Anzahl von Zeichen hat. Wenn der Längenwert negativ ist, wird NIL zurückgegeben.

1 Text Text
2"length"Zahl Länge des Teiltextes, der zurückgegeben werden soll

lower(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den übergebenen Text in Kleinschreibung zurück.

1 Text Text

max(case-sensitive:bool,str,str,...) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den nach alphabetischer Sortierung letzten Wert der übergebenen Liste zurück.

1"case-sensitive"Schalter Gibt an, ob Groß-/Kleinschreibung bei der Sortierung berücksichtigt werden soll
2 Text,1-* 2 oder mehr Texte

min(case-sensitive:bool,str,str,...) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den nach alphabetischer Sortierung ersten Wert der übergebenen Liste zurück.

1"case-sensitive"Schalter Gibt an, ob Groß-/Kleinschreibung bei der Sortierung berücksichtigt werden soll
2 Text,1-* 2 oder mehr Texte

nil() -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen ein Textwert erwartet wird. Keiner

objectPathLiveStr(path:str) -> str

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Text)

Gibt den Textwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableStr(path:str) -> str

Verwendbar in: Formelfelder

Rückgabewert(Text)

Gibt den Textwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

postalCode(location) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt die Postleitzahl einer Adresse aus einem Ortswert zurück.

1 Ort Ortswert

replace(str,regex:str,replacement:str,global:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Ersetzt im übergebenen Text eine/alle Vorkommen des angegebenen regulären Ausfrucks ("Regular Expression") durch den angegebenen Ersetzungstext und gibt das Ergebnis zurück. Es können auch Gruppen innerhalb des regulären Ausdrucks verwendet werden. Im Ersetzungstext kann auf die Gruppen anhand von Backslash "\" mit anschließendem Gruppenindex referenziert werden (z.B. ähnlich dem Befehlszeilentool "sed"). Falls ein Backslash im Ersetzungstext verwendet werden soll, so muss dieser gedoppelt werden, da er ansonsten als Escape-Sequenz gewertet wird.

1"value"Text Ursprungstext
2"regex"Text Regulärer Ausdruck
3"replacement"Text Ersetzungstext
4"global"Schalter Gibt an, ob alle Treffer (wahr) oder nur der erste Treffer (falsch) ersetzt werden soll

replace(str,substr:str,repl:str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Ersetzt im Ausgangstext einen Teil durch einen anderen und gibt das Ergebnis zurück. Es wird jedes Auftreten des zu ersetzenden Teils ersetzt.

1 Text Ausgangstext
2"substr"Text Zu ersetzender Text
3"repl"Text Text, der anstelle des zu ersetzenden Textes eingesetzt werden soll

right(str,length:num) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Teiltext einer bestimmte Länge vom Ende des übergebenen Textes zurück. Gibt den gesamten Text zurück, falls er weniger als die angegebene Anzahl von Zeichen hat. Wenn der Längenwert negativ ist, wird NIL zurückgegeben.

1 Text Text
2"length"Zahl Länge des Teiltextes, der zurückgegeben werden soll

stars(value:num,fillTo:num,with-halves:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt einen Text zurück, der die im übergebenen Wert angegebene Anzahl von ausgefüllten Sternen enthält. Sollte der Wert kleiner als der Wert des Parameters "fillTo" sein, dann werden weitere nicht ausgefüllte Sterne angehängt, bis die Anzahl von ausgefüllten und nicht ausgefüllten Sternen zusammen der des Parameters "fillTo" entspricht. Wenn der Parameter "withHalves" nicht gesetzt oder wahr ist, wird der Wert auf jeweils halbe Sterne gerundet und auch halbe Sterne angezeigt. 1: Anzahl von anzuzeigenden ausgefüllten Sternen. Negative Werte erzeugen das gleiche Ergebnis wie der Wert 0.

1"value"Zahl
2"fillTo"Zahl,optional Anzahl von insgesamt anzuzeigenden Sternen (meistens 5), falls nicht gesetzt, werden keine nicht-ausgefüllten Sterne angehängt (default: nicht auffüllen). Negative Werte erzeugen das gleiche Ergebnis wie der Wert 0.
3"with-halves"Schalter,optional Wenn auf "wahr" gesetzt, wird der Wert auf halbe Sterne gerundet, bei "falsch" nur auf ganze Sterne. (default: wahr)

strVal(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf eine Textwert festzulegen.)

1 Text Textwert

street(location) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt die Straße aus der Adresse eines Ortswertes zurück

1 Ort Ortswert

stripNonAlphanum(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Entfernt alle Zeichen aus der Zeichenkette, die nicht alphanumerisch sind und gibt das Ergebnis zurück.

1"value"Text Ursprungstext

substr(str,start:num,length:num) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Teiltext eines Ausgangstextes von einer Position mit einer bestimmten Länge zurück. Falls die Startposition größer als der letzte Zeichenindex des Ausgangstextes ist wird ein leerer Text zurückgegeben. Falls die Länge des Textes nicht ausreicht, wird ein entsprechend kürzerer Teiltext zurückgegeben. Falls Startindex oder Länge negativ sind, wird NIL zurückgegeben.

1 Text Ausgangstext
2"start"Zahl Startposition (0-basiert, 1. Stelle im Ausgangstext = 0)
3"length"Zahl Länge des zurückzugebenden Textes

title(location) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Titel (Anzeigewert) eines Ortswertes zurück.

1 Ort Ortswert

toString(value:num) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen numerischen Wert in einen Textwert um und gibt diesen zurück. Es werden dabei Ortsspezifika berücksichtigt, Dezimaltrenner verwendet und Nachkommastellen angezeigt.

1"value"Zahl Zahlenwert

toString(value:num,minIntegerDigits:num,minFractionDigits:num,maxFractionDigits:num,useGroupingSeparator:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen numerischen Wert in einen Textwert um und gibt diesen zurück. Es werden Ortsspezifika berücksichtigt.

1"value"Zahl Zahlenwert
2"minIntegerDigits"Zahl Minimale Anzahl von Stellen vor dem Komma. (Wenn dieser Wert > 1 ist, werden evtl. führende Nullen eingefügt.)
3"minFractionDigits"Zahl Minimale Anzahl von Stellen nach dem Komma.
4"maxFractionDigits"Zahl Maximale Anzahl von Stellen nach dem Komma.
5"useGroupingSeparator"Schalter Gibt an, ob die Dezimalstellen gruppiert werden sollen (z.B. 1.000.000 anstatt 1000000)

toStringDate(value:date) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen Datumswert in einen Textwert um und gibt diesen zurück. Es wird dabei die lokale Zeitzone angewendet und ein standardisiertes ortsspezifisches Format ohne Zeitangabe gewählt.

1"value"Datum Datumswert

toStringDateTZI(value:date) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen Datumswert in einen Textwert um und gibt diesen zurück. Es wird dabei die Zeitzone UTC angewendet und ein standardisiertes ortsspezifisches Format ohne Zeitangabe gewählt, .

1"value"Datum Datumswert

toStringDateTime(value:date,showSeconds:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen Datumswert in einen Textwert um und gibt diesen zurück. Es wird dabei die lokale Zeitzone angewendet und ein standardisiertes ortsspezifisches Format mit Zeitangabe gewählt.

1"value"Datum Datumswert
2"showSeconds"Schalter Wenn eingeschaltet, dann werden auch die Sekunden mit angezeigt

toStringDateTimeTZI(value:date,showSeconds:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen Datumswert in einen Textwert um und gibt diesen zurück. Es wird dabei die Zeitzone UTC angewendet und ein standardisiertes ortsspezifisches Format mit Zeitangabe gewählt.

1"value"Datum Datumswert
2"showSeconds"Schalter Wenn eingeschaltet, dann werden auch die Sekunden mit angezeigt

toStringTime(value:date,showSeconds:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen Datumswert in einen Textwert um und gibt diesen zurück. Es wird dabei die lokale Zeitzone angewendet und ein standardisiertes ortsspezifisches Format mit Zeitangabe ohne Datumsangabe gewählt.

1"value"Datum Datumswert
2"showSeconds"Schalter Wenn eingeschaltet, dann werden auch die Sekunden mit angezeigt

toStringTimeTZI(value:date,showSeconds:bool) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen Datumswert in einen Textwert um und gibt diesen zurück. Es wird dabei die Zeitzone UTC angewendet und ein standardisiertes ortsspezifisches Format mit Zeitangabe ohne Datumsangabe gewählt.

1"value"Datum Datumswert
2"showSeconds"Schalter Wenn eingeschaltet, dann werden auch die Sekunden mit angezeigt

trim(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Ausgangswert ohne führende und folgende Leerzeichen, Tabulatorzeichen und Zeilenumbrüche zurück.

1 Text Ausgangswert

upper(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den übergebenen Textwert in Großbuchstaben zurück.

1 Text Ausgangswert

urldecode(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen URL-kodierten Text zurück in einen unkodierten Text.

1"value"Text Text

urlencode(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Wandelt einen beliebigen Text so um, dass er in einem URL verwendet werden kann.

1"value"Text Text

value(str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Text Text

whenNil(value:str,default:str) -> str

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Text)

Gibt den Wert des ersten Parameters zurück oder, falls dieser ungültig oder nicht gefüllt (NIL) ist, den Wert des zweiten Parameters.

1"value"Text Wert, der zurückgegeben wird, falls er nicht NIL ist.
2"default"Text Wert, der zurückgegeben wird, falls der erste Parameter NIL ist.

Zahl

*(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Multipliziert die übergebenen Zahlenwerte miteinander und gibt das Ergebnis zurück.

1 Zahl,2-* 2 oder mehr Zahlenwerte, die miteinander multipliziert werden

*(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Multipliziert die Einzelwert der übergebenen Liste von Zahlenwerten miteinander und gibt das Ergebnis zurück. Falls die Liste der Elemente leer ist, wird 1 zurückgegeben.

1 Liste von Zahlen Liste von Zahlenwerten, die miteinander multipliziert werden

+(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Addiert die übergebenen Zahlenwerte miteinander und gibt das Ergebnis zurück.

1 Zahl,1-* 2 oder mehr Zahlenwerte, die miteinander addiert werden

+(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Addiert die Einzelwert der übergebenen Liste von Zahlenwerten miteinander und gibt das Ergebnis zurück. Falls die Liste der Elemente leer ist, wird 0 zurückgegeben.

1 Liste von Zahlen Liste von Zahlenwerten, die miteinander addiert werden

-(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Zieht die an 2. - x. Stelle übergebenen Zahlenwerte von der 1. übergebenen Zahl ab und gibt das Ergebnis zurück.

1 Zahl,2-* 2 oder mehr Zahlen, wobei alle weiteren von der ersten übergebenen Zahl abgezogen werden.

/(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Teilt die an 1. Stelle übergebene Zehl nacheinander durch alle weiteren übergebenen Werte und gibt das Ergebnis zurück.

1 Zahl,2-* 2 oder mehr Zahlen, wobei die erste übergebene Zahl durch alle weiteren geteilt wird.

abs(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Betrag der übergebenen Zahl zurück.

1 Zahl Zahlenwert

avg(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Durchschnittswert aller übergebenen Zahlenwerte zurück.

1 Zahl,1-* 2 oder mehr Zahlenwerte

avg(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt den Durchschnittswert der als Liste übergebenen Zahlenwerte zurück. Bei einer leeren Liste wird NIL zurückgegeben, da in diesem Fall kein Durchnittswert berechnet werden kann.

1 Liste von Zahlen Liste von Zahlenwerten

avgRating() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt die durchschnittliche Bewertung von allen Nutzern (siehe Feldtyp "Kommentar") für das jeweilige Dokument als Zahlenwert zwischen 0 und 5 (inkusive) zurück. (Kann z.B. in Kombination mit der Funktion "stars" verwendet werden, um eine Sternewertung anzuzeigen. Keiner

ceil(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Rundet die übergebene Zahl auf die nächsthöhere Ganzzahl auf und gibt das Ergebnis zurück. (ceil(1,2) = 2, ceil(-1,2) = -1)

1 Zahl Zahlenwert

count(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt die Anzahl der in der übergebenen Liste enthaltenen Elemente zurück.

1 Liste von Zahlen Liste von Zahlenwerten

count(strArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt die Anzahl der in der übergebenen Liste enthaltenen Elemente zurück.

1 Liste von Texten Liste von Textwerten

count(type,query?) -> num

Verwendbar in: Ereignisse

Rückgabewert(Zahl)

Zählt die Dokumente einen Typs in der Datenbank, die einer bestimmten Bedingung entsprechen

1"type"Typ Typ
2"query"Abfrage,optional Bedingung, der die zu zählenden Dokumente entsprechen sollen

datediff(from:date,until:date,unit:str) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die Differenz zwischen zwei Datumswerten in einer bestimmten Datumseinheit zurück (z.B. die Differenz in Tagen). Es wird die Differenz des zweiten Wertes minus den zweiten Wert zurückgegeben. (Der Wert ist positiv, wenn das zweite Datum nach dem ersten Datum liegt. Datumswerte verwenden die jeweils lokale Zeitzone.)

1"from"Datum 1. Datum
2"until"Datum 2. Datum
3"unit (y/m/w/d/h/i/s)"Text Kürzel für die zu verwendende Zeiteinheit (Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde)

datediffTZI(from:date,until:date,unit:str) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die Differenz zwischen zwei Datumswerten in einer bestimmten Datumseinheit zurück (z.B. die Differenz in Tagen). Es wird die Differenz des zweiten Wertes minus den zweiten Wert zurückgegeben. (Der Wert ist positiv, wenn das zweite Datum nach dem ersten Datum liegt. Datumswerte verwenden die Zeitzone UTC.)

1"from"Datum 1. Datum
2"until"Datum 2. Datum
3"unit (y/m/w/d/h/i/s)"Text Kürzel für die zu verwendende Zeiteinheit (Einheiten: y - Jahr, m - Monat, w - Woche, d - Tag, h - Stunde, i - Minute, s - Sekunde)

day(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Tages im Monat eines Datumswertes zurück (orts- bzw. kalenderabhängig), im gregorianischen Kalender z.B. day(14.08.2018) = 14.

1 Datum Datumswert

dayOfWeek(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Tages der Woche eines Datumswertes zurück (orts- bzw. kalenderabhängig), im gregorianischen Kalender: Sonntag = 1, Montag = 2, ..., Samstag = 7

1 Datum Datumswert

dayOfWeekTZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Tages der Woche eines Datumswertes zurück (kalenderabhängig, relativ zur Zeitzone UTC), im gregorianischen Kalender: Sonntag = 1, Montag = 2, ..., Samstag = 7

1 Datum Datumswert

dayOfYear(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Tages im Jahr eines Datumswertes zurück (orts- bzw. kalenderabhängig), im gregorianischen Kalender 1. Januar = 1, 31.Dezember = 365 bzw. 366.

1 Datum Datumswert

dayOfYearTZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Tages im Jahr eines Datumswertes zurück (kalenderabhängig, relativ zur Zeitzone UTC), im gregorianischen Kalender 1. Januar = 1, 31.Dezember = 365 bzw. 366.

1 Datum Datumswert

dayTZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Tages im Monat eines Datumswertes zurück (kalenderabhängig relativ zur Zeitzone UTC), im gregorianischen Kalender z.B. day(14.08.2018) = 14.

1 Datum Datumswert

differenceOfDisLikes() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt die Anzahl von "Likes" minus die Anzahl von "Dislikes" für das jeweilige Dokument zurück. (siehe FeldTyp "Like") Keiner

element(numArray,index:num) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt das Element an der übergebenen Stelle der Liste zurück oder NIL, falls die angegebene Stelle in der Liste nicht existiert.

1 Liste von Zahlen List von Zahlenwerten
2"index (0-(n-1))"Zahl Index der Stelle innerhalb der Liste (0-basiert: die 1. Stelle hat den Index 0)

emitted() -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt bei Verwendung von Sortierkriterien mit Mehrfachausgabe den für den jeweiligen Datensatz ausgegebenen Wert zurück. (Beispiel: Wenn das Feld der Mehrfachausgabe drei Werte "1", "2" und "3" enthält, dann werden in der Liste 3 Einträge ausgegeben. Die emitted()-Funktion gibt dann jeweils für einen der Datensätze den Wert "1", "2" bzw. "3" zurück.)
Gilt nur für Ansichten und Export, in Formularen ist der Wert leer. (ab Version 1.0.3) Keiner

first(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt das erste Element aus der Liste zurück oder NIL, falls die Liste keine Elemente hat.

1 Liste von Zahlen Liste von Zahlenwerten

floor(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Rundet die übergebene Zahl auf die nächstniedrigere Ganzzahl AB und gibt das Ergebnis zurück. (floor(1,8) = 1, floor(-1,8) = -2)

1 Zahl Zahlenwert

getProperty(alias,property) -> num

Verwendbar in: Ereignisse

Rückgabewert(Zahl)

Gibt den Wert eines Zahlenfeldes eines im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Feld Name des Feldes

getValue(alias,property) -> num

Verwendbar in: Ereignisse

Rückgabewert(Zahl)

Gibt den Wert eines Zahlenfeldes eines untypisierten (z.B. durch emptyDict erzeugten) im Arbeitsspeicher befindlichen Dokuments zurück.

1"alias"Dokument Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist.
2"property"Text Name des Feldes

getVariable(name:str) -> num

Verwendbar in: Ereignisse

Rückgabewert(Zahl)

Gibt den Wert einer Variablen vom Typ "Zahl" zurück.

1"name"Variable Name einer vorhandenen Variable des Typs "Zahl".

hour12(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Stundenwert eines Datumswertes im 12-Stundensystem in der lokalen Zeitzone zurück. (0-11)

1 Datum Datumswert

hour12TZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Stundenwert eines Datumswertes im 12-Stundensystem in der Zeitzone UTC zurück. (0-11)

1 Datum Datumswert

hour24(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Stundenwert eines Datumswertes im 24-Stundensystem in der lokalen Zeitzone zurück zurück. (0-23)

1 Datum Datumswert

hour24TZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Stundenwert eines Datumswertes im 24-Stundensystem in der Zeitzone UTC zurück. (0-23)

1 Datum Datumswert

if(condition:bool,then:num,else:num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt einen von zwei Zahlenwerten zurück, je nachdem ob die Bedingung wahr oder falsch ist

1"condition"Schalter Bedingung
2"then"Zahl Wert, der zurückgegeben wird, wenn die Bedingung zutrifft
3"else"Zahl Wert, der zurückgegeben wird, wenn die Bedingung nicht zutrifft

last(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt den letzten Wert der Liste von Zahlenwerten zurück oder NIL, falls die Liste keine Einträge hat.

1 Liste von Zahlen Liste von Zahlenwerten

latitude(location) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Breitengrad des übergebenen Ortswertes als Dezimalwert zurück. (Nord = positiv, Süd = negativ)

1 Ort Ortswert

length(value:str) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die Anzahl der Zeichen des übergebenen Textwertes zurück.

1"value"Text Textwert

longtiude(location) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Längengrad des übergebenen Ortswertes als Dezimalwert zurück. (Ost = positiv, West = negativ)

1 Ort Ortswert

max(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die größte der übergebenen Zahlen zurück.

1 Zahl,1-* 2 oder mehr Zahlenwerte

max(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt den größten Wert aus der übergebenen Liste von Zahlenwerten zurück oder NIL, falls die Liste keine Elemente hat.

1 Liste von Zahlen Liste von Zahlenwerten

maxRating() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt den höchsten Bewertungswert (siehe Feldtyp "Kommentar") zurück, der für das aktuelle Dokument vergeben wurde oder NIL, falls noch keine Bewertung vergeben wurde. Keiner

min(num,num,...) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die niedrigste der übergebenen Zahlen zurück.

1 Zahl,1-* 2 oder mehr Zahlenwerte

min(numArray) -> num

Verwendbar in: Formelfelder,Summenformeln in Ansichten,Ereignisse

Rückgabewert(Zahl)

Gibt den niedrigsten Wert aus der übergebenen Liste von Zahlenwerten zurück oder NIL, falls die Liste keine Elemente hat.

1 Liste von Zahlen Liste von Zahlenwerten

minRating() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt den niedrigsten Bewertungswert (siehe Feldtyp "Kommentar") zurück, der für das aktuelle Dokument vergeben wurde oder NIL, falls noch keine Bewertung vergeben wurde. Keiner

minute(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert der Minute eines Datumswertes zurück (orts- bzw. kalenderabhängig).

1 Datum Datumswert

minuteTZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert der Minute eines Datumswertes zurück (kalenderabhängig, in Zeitzone UTC).

1 Datum Datumswert

mod(num,num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Modulo-Wert (Rest) zurück, der beim Teilen der ersten Zahl durch die zweite Zahl entsteht.

1 Zahl,2 2 Zahlen, wobei die erste durch die zweite geteilt wird

month(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Monats eines Datumswertes zurück (orts- bzw. kalenderabhängig). Im gregorianischen Kalender Januar = 1, ..., Dezember = 12

1 Datum Datumswert

monthTZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Monats eines Datumswertes zurück (kalenderabhängig, in Zeitzone UTC). Im gregorianischen Kalender Januar = 1, ..., Dezember = 12

1 Datum Datumswert

neg(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Dreht das Vorzeichen des übergebenen Wertes um. neg(-2) = 2, neg(3) = -3

1 Zahl Ausgangswert

nil() -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt einen leeren Wert zurück, z.B. um ihn einer Eigenschaft eines Datensatzes zuzuweisen um dessen Wert zu löschen. Kann an Stellen verwendet werden, an denen ein Zahlenwert erwartet wird. Keiner

numVal(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion kann verwendet werden, um an Stellen im Code mit mehrdeutigem Typ den Typen auf einen Zahlenwert festzulegen.)

1 Zahl Zahlenwert

numberOfComments() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt die Anzahl von für das Dokument abgegebenen Kommentaren (siehe Feldtyp "Kommentar") zurück. Keiner

numberOfDislikes() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt die Anzahl von für das Dokument abgegebenen Dislikes (siehe Feldtyp "Like") zurück. Keiner

numberOfLikes() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt die Anzahl von für das Dokument abgegebenen Likes (siehe Feldtyp "Like") zurück. Keiner

numberOfRatings() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt die Anzahl von für das Dokument abgegebenen Bewertungen (siehe Feldtyp "Kommentar") zurück. Keiner

objectPathLiveNum(path:str) -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Anmerkungen:

Rückgabewert(Zahl)

Gibt den Zahlenwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Anzeigezeitpunkt ("Lazy") ausgelesen, der Wertinhalt kann deshalb aber nicht zur Sortierung oder Suche verwendet werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

objectPathSearchableNum(path:str) -> num

Verwendbar in: Formelfelder

Rückgabewert(Zahl)

Gibt den Zahlenwert eines über eine Relation verbundenen Objekts zurück, der anhand des Pfadausdrucks ermittelt wird. Der Pfad wird zum Zeitpunkt des Speicherns des Basisdokuments ausgelesen und verändert sich nicht, falls sich Daten im referenzierten Datensatz ändern. Dafür kann der Wert gesucht bzw. nach dem Wert sortiert werden.

1"path"Text Pfadausdruck: Der technische Name eines Relationen-Feldes gefolgt von einem "." und dem technischen Namen eines Feldes des referenzierten Typs. Falls dieses Feld wiederum ein Relationsfeld ist, kann ein weiterer Name eines Feldes des von diesem Feld referenzierten Typs mit "." getrennt angehängt werden.

pctLikes() -> num

Verwendbar in: Formelfelder,Ereignisse (bekommt einen weiteren Parameter für das referenzierte Dokument bei Verwendung in Ereignissen)

Rückgabewert(Zahl)

Gibt den Anteil von Likes (siehe Feldtype "Like") an der Summe der Likes und Dislikes als Prozentzahl (0-100) zurück. Keiner

pi() -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die Zahl "Pi" (3,1415...) zurück Keiner

pow(num,num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt die Potenz der angegebenen Basis mit dem angegebenen Exponenten zurück.

1 Zahl,2 2 Zahlenwerte: Basis und Exponent

rand(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt eine zufällige ganze Zahl größer oder gleich 0 und kleiner dem übergebenen Wert zurück.

1 Zahl Wert

round(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Rundet die Zahl auf die nächstliegende Ganzzahl, Halbe werden zur nächsten Ganzzahl von der 0 weg (kaufmännisch) gerundet. round(10,5) = 11, round(-10,5) = -11

1 Zahl Zahlenwert

sig(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Signumsfunktion. Gibt für positive Zahlen den Wert 1, für negative Zahlen den Wert -1 und für die 0 den Wert 0 zurück.

1 Zahl Zahlenwert

sqrt(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert der Quadratwurzel aus dem übergebenen Wert zurück. Falls aus dem Wert keine Wurzel gezogen werden kann (z.B. negative Zahlen) wird NIL zurückgegeben.

1 Zahl Zahlenwert

srand(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt eine zufällige ganze Zahl größer oder gleich 0 und kleiner dem übergebenen Wert zurück. Es wird dabei ein kryptographisch geeignetes Verfahren verwendet.

1 Zahl Wert

toNumber(value:bool) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Erzeugt einen Zahlenwert aus einem Wahrheitswert: "Wahr" wird zu 1 und "Falsch" zu 0.

1"value"Schalter Wahrheitswert

toNumber(value:str) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Wandelt einen Text in einen numerischen Wert, soweit der Text einen numerischen Wert enthält. Das Zahlenformat ist ortsabhängig.

1"value"Text Text, der einen numerischen Wert enthält.

value(num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den übergebenen Parameter-Wert unverändert zurück. (Diese Funktion wird verwendet um an Stellen konstante Werte verwenden zu können, an denen nur die Verwendung von Funktionen möglich ist.)

1 Zahl Zahlenwert

whenNil(value:num,default:num) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des ersten Parameters zurück oder, falls dieser ungültig oder nicht gefüllt (NIL) ist, den Wert des zweiten Parameters.

1"value"Zahl Wert, der zurückgegeben wird, falls er nicht NIL ist.
2"default"Zahl Wert, der zurückgegeben wird, falls der erste Parameter NIL ist.

year(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Jahres eines Datumswertes zurück (orts- bzw. kalenderabhängig).

1 Datum Datumswert

yearTZI(date) -> num

Verwendbar in: Formelfelder,Ereignisse

Rückgabewert(Zahl)

Gibt den Wert des Jahres eines Datumswertes zurück (kalenderabhängig, in der Zeitzone UTC).

1 Datum Datumswert