Omnisgrundlagen

Omnis-Funktionen

Omnisfunktionen verändern oder beschaffen sich Informationen über einen Wert und geben diesen zurück. In den Klammern werden die Parameter mitgegeben. Parameter mit [] Klammern sind optional. Grundsätzlich können Funktionen beliebig verschachtelt werden.
Beispiel: con('Test',upp(left('Wort',2))) Returns TestWO

left() / right()

Schneidet einem String von einer Seite n Zeichen weg.

Definition

left(string,n) / right(string,n) Returns Abgeschnittener Teil des Strings

Beispiel

left('Hallo',2) Returns Ha
right('Test',3) Returns est

con()

Fügt n Strings zu einem zusammen.

Definition

con(String1,String2,String3,...) Returns Zusammengesetzter String

Beispiel

con('Schönes','Wetter') Returns Schönes Wetter
con('AT-Wert: ',[Attribut]) Returns AT-Wert: Attributwert

upp()

Wandelt alle Buchstaben in einem String in Grossbuchstaben um

Definition

upp(String) Returns String in Grossbuchstaben

Beispiel

upp('Test') Returns TEST

len()

Gibt die Länge eines Strings zurück

Definition

len(String) Returns Länge (int)

Beispiel

len('Test') Returns 4

isclear()

Gibt Ja oder Nein zurück ob der Wert Leer oder NULL ist

Definition

isclear(Expression) Returns Ja/Nein

Beispiel

isclear(variable) Returns Ja
isclear(len('Test')) Returns Nein
isclear(right('Test',0))) Returns Ja

not()

Verneint die mitgegebene Expression

Definition

not(Expression) Returns negierte Expression

Beispiel

not(isclear(len('Test'))) Returns Ja (isclear(len('Test')) wäre Nein)

platform()

Gibt das Betriebssystem des aktuell codeausführenden Gerätes zurück. X = macOS, N = Windows

Definition

platform() Returns X oder N

Beispiel

platform() Returns X

randintrng()

Gibt eine zufällige Zahl in der mitgegeben Range zurück

Definition

randintrng(number1,number2) Returns int

Beispiel

randintrng(1,100) Returns 45

isnumber()

Gibt Ja oder Nein zurück ob der String eine Nummer ist oder nicht

Definition

isnumber(String,[decimal-char],[thousands-char]) Returns Ja / Nein

Beispiel

isnumber('Test') Returns Nein
isnumber('333') Returns Ja
isnumber("3'33.45",'.',"'") Returns Ja

pos()

Gibt die Position des Substrings im String zurück. 0 falls der Substring nicht vorkommt

Definition

pos(substring,string) Returns Position

Beispiel

pos('e','Test') Returns 2
pos('x','Test') Returns 0
Pos('llo','Hallo') Returns 3

pick()

Gibt ein definiertes Resultat aufgrund einer Kalkulation zurück

Definition

pick(number,value1,value2,value3,...) Returns Value

Beispiel

pick(0,'Wert1','Wert2') Returns Wert1
pick(1,'Wert1','Wert2') Returns Wert2
pick(len('Hallo')=5,'Wert1','Wert2') Returns Wert2

replaceall()

Ersetzt einen Text durch einen anderen.

Definition

replacall(Quelltext,Suchtext,Ersatztext) Returns Ergebnis

Beispiel

replaceall('Hallo Barnie','a','e') ergibt 'Hello Bernie'
replaceall('GH III 3.4',' ','_') ergibt 'GH_III_3.4'

replace()

Gleiche Funktion wie replaceall, ersetzt aber nur das erste Vorkommen des Suchtextes.

Beispiel

replace('Hallo Barnie','a','e') ergibt 'Hello Barnie'
replace('GH III 3.4',' ','_') ergibt 'GH_III 3.4'

Omnis-Konstanten

Konstanten (zB. kCr) sind Behälter für fixe Werte deren Zuweisung nicht verändert werden kann. Im Omnis ersetzten sie meist Zahlencodes um die Usability zu erhöhen. Ein Beispiel: kRed (die Farbe Rot) verkörpert den Wert "-2147483607".

Konstante	Bedeutung
kCr	Zeilenumbruch
kLf	Linefeed
kSp	Leerschlag
kSq	Single Quote (')
kDq	Double Quote (")
kRed	Farbe Rot (viele weitere Farben möglich)
kTab	Tabulator
#D	Datum & Uhrzeit
kTrue	Ja - Wert 1
kFalse	Nein - Wert 0

Spezielles Eingabefeld

Dieses Eingabefeld validiert vor zu den Input und gibt zurück ob es sich um eine valide Omniskalkulation handelt. Das beste daran ist, dass es gar keine Kalkulation sein muss. Wenn einfach ein Text drin steht wird wie üblich einfach dieser Text verwendet. Erkennt es aber eine Omniskalkulation wird diese evaluiert und Attribute ersetzt. Sobald der Wert jedoch ein $ enthält wird er nicht evaluiert um Omnis Injection vorzubeugen.

Gültige Omnisfunktion

Ein simpler Text