Funktionen im Feldeditor (Regeln)

Im Feldeditor können - wie im Druckdesigner - Operatoren und Funktionen genutzt werden.

Beachten Sie:

Diese Funktionen werden je nach Verwendungszweck (Exportfilter, Bedingungen in Regeln) mit einem $-Zeichen an erster Stelle eingegeben.

Sofern eine Funktion verwendet wird, die parametrisiert werden kann, muss dies in der Regelbedingung anders als in einer Regelanweisung eingegeben werden.

Beispielsweise kann die Funktion "**GetAktDate()**" z. B. folgende Parameter enthalten: "Time" oder auch "Server, Time".

Regel-Bedingung	Regel-Anweisung
GetAktDate(**'Time'**)	**$**GetAktDate(**Time**)
GetAktDate(**'Server', 'Time'**)	**$**GetAktDate(**Server, Time**)

Folgende Operatoren können verwendet werden

1. Vergleichs-Operatoren

• and:
• ( a ) and ( b )
  • a und b müssen Wahr sein
  • ( «SollBetLW1» = «HabenBetLW1» ) and ( «SollBetLW2» = «HabenBetLW2» )
• or:
• ( a ) or ( b )
  • a oder b muss Wahr sein
  • ( «SollBetLW1» = «HabenBetLW1» ) or ( «SollBetLW2» = «HabenBetLW2» )
• <>:
• ( a ) <> ( b )
  • Wenn a sich von b unterscheidet ist das Ergebnis Wahr
  • «AdrNr» <> '10000'

2. Verneinungs-Operator (Negation)

• not:
• **not ( a )**
  • a muss FALSCH sein, um als Ergebnis Wahr zu erhalten
• **not ( «SollBetLW1» = «HabenBetLW1» )**
  • SollBetLW1 und HabenBetLW1 müssen sich unterscheiden, um als Ergebnis Wahr zu erhalten

3. Mengen-Operator

• in:
• **( a in ( b ) )**
• ( Wert in ( Werte-Menge ) )
  • Wenn a (Wert) in b (Werte-Menge) vorliegt ist das Ergebnis Wahr

• **«AdrNr» in ('10000', '10001')**

  • Dies ist eine absolute Definition.
  • Es werden nur durch Komma Werte gefunden (durch Komma separierte Werte müssen nach jedem Komma ein Leerzeichen besitzen, damit diese ausgewertet werden können).
  • Ein Bereich kann nicht mit dem Operator "in" abgefragt werden.

  Tipp:

  Wollen Sie einen "von - bis" Bereich, so können Sie folgende Bedingung definieren:

  **Pos('100',«AdrNr»)>0**

  Ein mit dieser Formel definierter Filter zeigt alle Adressen an, die '100' enthalten. (Vgl. Sie auch mit der Beschreibung der Funktion Pos() weiter unten).

Folgende Funktionen können in den Filter- bzw. in den Regelbedingungen genutzt werden

Text / String-Funktionen

• ToString(\[Wert\]) oder bei Filter auch mal ToText(\[Wert\]) möglich
• Wandelt den Wert in einen String um
• Left(\[String\],\[Anzahl der Zeichen\])
• Left(a,n)
  • Die ersten n Zeichen von dem String a werden zurückgegeben
• Left('TEST',2)
  • Die ersten 2 Zeichen von dem String: "TEST" werden zurückgegeben. Ergebnis: "TE"
• Left(«AdrNr»,3) = '100'
  • Die ersten 3 Zeichen von der String-Variable: "AdrNr (Adressnummer)" werden mit dem Wert: "100" verglichen. Das Ergebnis ist positiv, sofern die AdrNr (Adressnummer) mit einer 100 beginnt.
• Right****(\[String\],\[Anzahl der Zeichen\])
• Right(a,n)
  • n Zeichen von rechts von dem String a werden zurückgegeben
• Right('TEST',2)
  • Die letzten 2 Zeichen von dem String: "TEST" werden zurückgegeben. Ergebnis: "ST"
• Right(«AdrNr»,3) = '100'
  • Die letzten 3 Zeichen von der String-Variable: "AdrNr (Adressnummer)" werden mit dem Wert: "100" verglichen. Das Ergebnis ist positiv, sofern die AdrNr (Adressnummer) mit einer 100 endet.
• Mid(\[String\],\[Start-Position\],\[Anzahl der Zeichen\])
• Mid(a,n1,n2)
  • Ab der Position n1 werden n Zeichen von dem String a zurückgegeben
• Mid("TEST",2,2)
  • Ab der Position 2 werden 2 Zeichen von dem String "TEST" zurückgegeben. Ergebnis: "ES"

• Mid(«AdrNr», 3, 3) = '100'

  • Ab der Position 3 werden 3 Zeichen von der String-Variable: "AdrNr (Adressnummer)" mit dem Wert: "100" verglichen

  • Beachten Sie, dass nach dem Komma jeweils ein Leerzeichen angegeben wird, ansonsten kann die Formel nicht ausgewertet werden

  • Beispiel mit oben genannter Formel: Das Ergebnis ist dann positiv, sofern die AdrNr (Adressnummer) z. B. "10100" ist, da ab Position 3 die Bedingung für 3 Zeichen wahr ist.

  • Pos(\[Such-String\],\[String\])
  • Gibt die Position von dem gesuchten String innerhalb eines Strings zurück.
  • Pos("c","abc")
  • Sucht "c" innerhalb von "abc" und gibt die Position zurück. Das Ergebnis ist: "3"

  Beachten Sie:

  Eine Pos-Funktion in einem E-Mail-Layout gibt immer den Rückgabewert "Leer" zurück, sofern der gesuchte Text nicht enthalten ist.

  Sofern man eine Pos-Funktion in einer Cond - / If Bedingung verwendet, muss man einen Vorgabewert / Vergleichswert mit übergeben (als 3. Angabe). Dieser Vorgabewert wird dann zurückgegeben, sofern der gesuchte Text nicht verfügbar ist.

  Beispiele:

  • Allgemein: $Cond($Pos(\[Suchwort\],\[Feld\],0)<>0,JA,NEIN)
  • Vorgangsart: Angebot - Layout: Angebots-Mail - Feld: Empfänger-Formel:
    $Cond($Pos("AN",«BelegNr»,0)<>0, [true@microtech.de](mailto:true@microtech.de), [false@microtech.de](mailto:false@microtech.de))
    • Liefert die E-Mailadresse: "true@" $Cond($Pos("AG",«BelegNr»,0)<>0, [true@microtech.de](mailto:true@microtech.de), [false@microtech.de](mailto:false@microtech.de))
    • Liefert die E-Mailadresse: "false@"
    • $Cond($Pos("AG",«BelegNr»,0)<>0, [true@microtech.de](mailto:true@microtech.de))
    • Liefert keine E-Mailadresse bzw. würde dann als Empfänger-Mailadresse einfach nichts ("Leer") eintragen.

• Length(\[String\]): XL

• Die Zeichenlänge eines Strings werden zurückgeliefert
• Length("Ich bin ein Test!")
  • Das Ergebnis liefert den Wert "17" zurück.

• GetAktBzr():

• Das Benutzerkürzel des aktuellen Benutzers wird zurückgeliefert

Date / Time-Funktionen

• Date(\[Wert\]) oder ToDate(\[Wert\])
• Wandelt den Wert in ein Datum um
• Date('01.01.80')
  • Der Wert "01.01.80" kann mit einem Datumsfeld verglichen werden
• Time(\[Wert\]) oder ToTime(\[Wert\])
• Wandelt den Wert in eine Uhrzeit um
• Time('08:30:00')
  • Der Wert "08:30:00" kann mit einen Zeitfeld verglichen werden
• DateTime(\[Wert\]) oder ToDateTime(\[Wert\])
• Wandelt den Wert in ein Datum mit Uhrzeit um
• DateTime('01.01.80 08:30:00')
  • Der Wert "01.01.80 08:30:00" kann mit einen DatumZeitfeld verglichen werden
• Year(\[Date oder DateTime\])
• Die Jahreszahl wird zurückgeliefert
• Month(\[Date oder DateTime\])
• Der Monat wird zurückgeliefert
• Day(\[Date oder DateTime\])
• Der Tag innerhalb des Monats wird zurückgeliefert
• Hour(\[Date oder DateTime\])
• Die Stunde wird zurückgeliefert
• Minute(\[Date oder DateTime\])
• Die Minute wird zurückgeliefert
• Second(\[Date oder DateTime\])
• Die Sekunde wird zurückgeliefert
• GetDate()
• Das aktuelle Systemdatum wird zurückgeliefert
• GetAktDate()
• Das aktuelle Programmdatum wird zurückgeliefert

• GetAktDate('Time') L

  • Das aktuelle Arbeitsdatum mit Uhrzeit wird zurückgeliefert.

• GetAktDate('Server') L

  • Das aktuelle Serverdatum (Datum des Server-PCs) wird zurückgeliefert.

  • GetAktDate('Server, Time') L

  • Das aktuelle Serverdatum mit Uhrzeit (Datum des Server-PCs) wird zurückgeliefert.

  Info:

  Beispiel: Über eine Formel können Sie z. B. die aktuelle Systemzeit des aktuellen Tages prüfen, ob diese größer oder gleich 11:00:00 Uhr ist und bei Zutreffen der Bedingung verschiedene Aktionen konfigurieren. So lassen sich eigene Abläufe anhand der Zeit bzw. des Datums konfigurieren.

  GetAktDate('Time') >= Time('11:00:00')

• DiffDate(\[Start-Datum\],\[End-Datum\]) XL

• Ermittelt die Anzahl der Tage zwischen zwei Daten
• Als Rückgabewert erhält man eine ganzzahlige Anzahl der Tage.
  • DiffDate(1.1.2022,2.1.2022)
  • Das Ergebnis ist: "1"
  • DiffDate(1.1.2022,1.1.2022)
  • Das Ergebnis ist: "0"
  • DiffDate(2.1.2022,1.1.2022)
  • Das Ergebnis ist: "-1"
• Beispiele:
  • DiffDate(«VPo.LiefDat»,GetAktdate()) > 3
  • Es soll bei der Erfassung einer Vorgangsposition geprüft werden, ob das Lieferdatum der Position größer als das aktuelle Datum + 3 ist.
  • DiffDate(«LiefDat»,Getaktdate()) > 2
  • In einer Vorgangsliste sollen nur Vorgänge ausgegeben werden deren Lieferdatum älter als 2 Tage als das aktuelle Datum sind.
• Damit lässt sich z.B. auch ein UNIX Zeitstempel berechnen.
  • Beispiel für das Vorgangs-Datum in einer Tabellenansicht:
  • $Calc($DiffDate(01.01.1970 00:00:00,«Vog.Dat»)*86400,Menge)

Boolean (Kennzeichen)-Funktion

• ToBool([Wert])
• Wandelt den Wert in ein Boolean (Ja/Nein) um

Integer / Float (Zahlen / Fließkommazahl)-Funktionen

• ToInt([Wert])
• Wandelt den Wert in eine Ganzzahl um
• ToFloat([Wert])
• Wandelt den Wert in eine Fließkommazahl um

Sonder-Funktion

• CalcUmsatz([Anzahl der letzten Monate])
• Berechnet den Umsatz der letzten angegebenen Monate

DBInfo-Funktion

• DBInfo('Name der Datentabelle', Schlüsselwert[e],'Zielfeldname')
• Findet in der Datentabelle "Name der Datentabelle" den Datensatz mit dem entsprechenden "Schlüsselwert" und gibt den Inhalt des Feldes "Zielfeldname" zurück.
• Mit Hilfe der DBInfo-Formeln kann ein Wert aus einer Datentabelle unter Verwendung eines Primärindex abgefragt werden.
  • Erläuterung zum Aufbau:
  • Name der Datentabelle
    • Name der Tabelle, aus der ein Wert abgefragt werden soll.
  • Schlüsselwert[e]
    • Kann beliebigen Typs sein. Sollte jedoch zum 1. Feld des Primärindex der abzufragenden Tabelle passen.
  • Zielfeldname
    • Optionaler Name des Feldes, dessen Wert zurück geliefert werden soll. Falls dieser Parameter ausgelassen wird, wird dieselbe Zeichenfolge zurückgegeben mit der der Datensatz z. B. beim Löschen bezeichnet wird.
• Die DBInfo-Formel steht Ihnen auch im Feldeditor zur Verfügung. Der inhaltliche Aufbau ist wie im DBInfo-Formeln für Bereichsfilter und Ausgabefilter.

• Beispiele:

  • DBInfo('Adressen',«AktVog.AdrNr»,'SteuNr')
  • Dadurch wird z.B. in einer Vorgangsliste das Feld Steuernummer der Adresse abgefragt.

  • DBInfo('Vorgang', «VPo.BelegNr» , 'ReLandKennz') = 'D'

  • Mit dieser Formel wird in der Auswertung "Vorgangsliste nur Positionen" das Landeskennzeichen der Rechnungsanschrift abgefragt.

Gen. 24

Vierten Parameter in DBInfo-Formel nutzen

Mit der Gen. 24 kann zusätzlich noch ein vierter Parameter eingegeben werden.

Dieser zusätzliche vierte Parameter gibt vor, welcher Wert ausgegeben werden soll, wenn der dritte Parameter nicht gefüllt ist.

Zum Vorstellen der Funktion wiederholen wir das eben gezeigte erste Beispiel - nun mit dem zusätzlichen vierten Parameter.

• DBInfo('Name der Datentabelle', Schlüsselwert[e],'Zielfeldname')
• Findet in der Datentabelle "Name der Datentabelle" den Datensatz mit dem entsprechenden "Schlüsselwert" und gibt den Inhalt des Feldes "Zielfeldname" zurück.
• Mit Hilfe der DBInfo-Formeln kann ein Wert aus einer Datentabelle unter Verwendung eines Primärindex abgefragt werden.
  • Erläuterung zum Aufbau:
  • Name der Datentabelle
    • Name der Tabelle, aus der ein Wert abgefragt werden soll.
  • Schlüsselwert[e]
    • Kann beliebigen Typs sein. Sollte jedoch zum 1. Feld des Primärindex der abzufragenden Tabelle passen.
  • Zielfeldname
    • Optionaler Name des Feldes, dessen Wert zurück geliefert werden soll. Falls dieser Parameter ausgelassen wird, wird dieselbe Zeichenfolge zurückgegeben mit der der Datensatz z. B. beim Löschen bezeichnet wird.
  • Vorgabe: Dieser Parameter wird als Ausgabe genutzt anstelle "Keine Eintragung...", wenn Zielfeldname leer (beim dritten Parameter).
• Die DBInfo-Formel steht Ihnen auch im Feldeditor zur Verfügung. Der inhaltliche Aufbau ist wie im DBInfo-Formeln für Bereichsfilter und Ausgabefilter.

• Beispiel:

  • DBInfo('Adressen',«AktVog.AdrNr»,'SteuNr','nicht vorhanden')
  • Dadurch wird z.B. in einer Vorgangsliste das Feld Steuernummer der Adresse abgefragt. Ist das Feld für die Steuernummer leer, wird der vierte Parameter mit dem Vorgabewert: "nicht vorhanden" ausgegeben.