Methoden

Nachfolgende Übersicht dient als Hilfe zur Nutzung der Importfunktionen zeigt weitere Möglichkeiten des Datenimportes auf.

Funktionen¶

Die aufgeführten Funktionen können innerhalb einer Importkonfiguration (XML-Konfigurationsdatei) angewendet werden, um Quelldaten zu konvertieren, zu prüfen oder mit anderen Informationen zu verbinden.

Konvertierungsfunktionen¶

Einen String in einen anderen Typ konvertieren, es stehen folgende Ziel-Datentypen zur Verfügung

Double
Float
Int
Long

Funktionen

cdouble(String in)
cfloat(String in)
cint(String in)
clong(Object in)

Beliebige andere Datentypen in einen String konvertieren cstring(Object in)

Beliebiges Datumsformat in das CortexEngine-Format konvertieren date(String format, String in)

Weitere Funktionen¶

Funktion	Beschreibung
`AND(Boolean v1, Boolean v2)`	AND Operation auf zwei boolesche Werte ausführen
`concat(String s1, String s2)`	Zwei Eingabestrings zu einem Ergebnisstring verbinden (concatenate)
`DIV(v1, v2)`	Liefert den Quotienten zweier numerischer Werte
`empty(String in)`	Gibt zurück, ob der übergebene String die Länge 0 besitzt
`endsWith(String str1, String end)`	Prüft, ob der Eingabestring (str1) mit dem Prüfstring (end) endet
`equals(String str1, String str2)`	Prüft, ob zwei Strings gleich sind
`file_extension(String file)`	Liefert die Erweiterung eines übergebenen Dateinamens
`file_woext(String file)`	Liefert den Dateinamen ohne Erweiterung einer Datei zurück, befreit von Pfadangaben
`file(String sFileName)`	Importiert eine Datei
`filename(String file)`	Liefert den Dateinamen einer Datei zurück, befreit von Pfadangaben
`filepath(String file)`	Liefert den absoluten Pfad einer Datei zurück
`findFirst(in, match)` `findFirst(in, match, startPos)`	Findet die erste Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück
`findLast(in, match)` `findLast(in, match, startPos)`	Findet die letzte Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück
`iif(Boolean ifclause, then, elsedo)`	Liefert `then`, wenn `ifclause` == true, sonst `elsedo`
`length(String str)`	Liefert die Länge eines Strings
`lower(String val)`	Wandelt einen String in Kleinbuchstaben um
`MINUS(v1, v2)`	Subtrahiert zwei numerische Werte voneinander
`MUL(v1, v2)`	Liefert das Produkt der beiden numerischen Werte
`normHnr(String in)`	Zur Normierung einer Hausnummer
`NOT(Boolean in)`	Gibt den übergebenen booleschen Wert negiert zurück
`notequals(String str1, String str2)`	Prüft, ob zwei Strings ungleich sind
`OR(Boolean v1, Boolean v2)`	Führt die OR Operation auf zwei boolesche Werte aus
`pad_left(String in, Integer len)`	gibt einen String zurück, bei dem die Zeichen des Eingabestrings rechtsbündig ausgerichtet sind, indem die linke Seite mit Leerzeichen aufgefüllt wird
`pad_right(String in, Integer len)`	gibt einen String zurück, bei dem die Zeichen des Eingabestrings linksbündig ausgerichtet sind, indem die rechte Seite mit Leerzeichen aufgefüllt wird
`pad_left(String in, String char, Integer len)`	gibt einen String zurück, bei dem die Zeichen des Eingabestrings rechtsbündig ausgerichtet sind, indem die linke Seite mit dem angegebenen Zeichen aufgefüllt wird
`pad_right(String in, String char, Integer len)`	gibt einen String zurück, bei dem die Zeichen des Eingabestrings linksbündig ausgerichtet sind, indem die rechte Seite mit dem angegebenen Zeichen aufgefüllt wird
`PLUS(v1, v2)`	addiert die beiden numerischen Werte
`replace(String sIn, String sSeek, String sRepl)`	ersetzt einen Suchstring im Eingabestring durch einen Ersatzstring
`rsubstring(String in, Integer start)`	liefert von dem Eingabestring alle Zeichen, ab dem gewünschten Startzeichen `start`
`split(String src, String splitStr, Integer n)`	liefert das n-te Element aus dem zerlegten Eingabestring
`sourceFileName()`	liefert den Dateinamen inkl. Extension der aufgerufenen Importdatei
`substring(String in, Integer start, Integer len)`	liefert von dem Eingabestring einen Teilstring mit der angegebenen Länge ab der übergebenen Startposition
`time(String date)`	wandelt ein String im Cortex-Datumsformat in einen Cortex-internen Long Zeitstempel um
`time()`	der Aufruf ohne Parameter liefert den aktuellen, minutengenauen Zeitstempel - für eine Nutzung als Verlaufsinformation ist eine Konvertierung mit der Date-Funktion notwendig
`trim(String in)`	führt einen Trim auf einen String aus
`upper(String val)`	wandelt einen String in Großbuchstaben um

Variablen in der Konfiguration¶

Insbesondere bei umfangreichen Importkonfigurationen ist es hilfreich, wenn bereits definierte Werte per Variable weiterverwendet werden können. Hierfür stehen vier Funktionen zur Verfügung.

Textwerte

Variablen können über zwei Funktionen gesetzt und gelesen werden

getVar(String Name) setVar(String Name, String Value)

Numerische Werte (double)

Doubles können mit einer erweiterten Funktion gesetzt und gelesen werden

getVarDouble(String Name) setVarDouble(String Name, String Value)

Variablen können nur rechtsseitig vom Gleichheitszeichen der Wertzuweisung verwendet werden können. Linksseitig vom Gleichheitszeichen (z.B. für die Bestimmung eines Verlaufsdatums) ist die Verwendung nicht möglich.