X3-Formeln

Zusammenfassung

In einer Reihe von Parametrierungsmasken müssen Berechnungsformeln erfasst werden, die auch als Adonix-Ausdrücke bezeichnet werden (die Ausführungs-Engine der in X3-Technologie geschriebenen Softwareprogramme heißt Adonix). Diese Ausdrücke werden in ein algebraischer Form ausgedrückt und zählen zu einer allgemeineren Sprache. Nachstehend werden die in diesen Formeln verwendbaren Funktionen allgemein beschrieben.

Bei der Erfassung von Formeln stehen zahlreiche Hilfefunktionen zur Verfügung, die sich sowohl auf die verwendbaren Funktionen und Variablen beziehen als auch auf die Erläuterung der Bedeutung der Formeln. Diese Hilfefunktionen sind auch imFormeleditorzugänglich.

Mit dem Taschenrechnerkönnen Ausdrücke (mit Konstanten und im Kontext verfügbaren Variablen) getestet werden.

Formeltyp

X3-Formeln können alphanumerisch, numerisch oder vom Typ Datum sein. Je nachdem, an welcher Stelle die Parametrierung durchgeführt wird, kann ein bestimmter Typ notwendig sein (obwohl in einer Formel alle Ausdruckstypen verwendet werden können, können Funktionen von einem bestimmten Typ Argumente von einem anderen Typ benötigen). Mit der Funktion Typ kann der Typ einer Variablen getestet werden.

Aufbau einer X3-Formel

Eine Formel setzt sich aus Konstanten, Operatoren, Variablen und Funktionen zusammen.

Konstanten

Mögliche Konstantentypen:

    alphanumerische Konstanten: in einfache oder doppelte Hochkommata gesetzt. Hier zwei Beispiele für gültige Zeichenketten:

    numerische Konstanten: mit Dezimalpunkt, sofern notwendig. Hier zwei Beispiele für gültige numerische Konstanten:

    Konstante vom Typ Datum: ausgedrückt im Format [ Tag / Monat / Jahr ]. Das Jahr muss vierstellig ausgedrückt werden. Hier zwei Beispiele für gültige Konstanten vom Typ Datum:

    logische Konstanten: numerische Konstanten, die genau zwei Werte annehmen können: 1 (oder beliebiger von null verschiedener Wert) = wahr, 0 = falsch.

Operatoren

Es stehen folgende Operatoren zur Verfügung:

Die Anzahl von Verschachtelungen ist unbegrenzt.

Variablen

Variablen werden im Allgemeinen in folgender Form ausgedrückt:

Beispiel:

Der Variablenname Variablenname wird mit Buchstaben und / oder Ziffern ausgedrückt, wobei es sich beim ersten Zeichen stets um einen Buchstaben handeln muss. Unterstriche sind ebenfalls zulässig. Es werden die ersten 12 Zeichen des Variablennamens ausgewertet. Außer einigen Schlüsselwörtern der Programmiersprache wieFile, Untilund Commit sind alle Namen erlaubt. Wird ein Variablenname in Kleinbuchstaben erfasst, so wird er automatisch in Großbuchstaben umgewandelt, sofern es sich nicht um ein Schlüsselwort handelt.

Manche Variablen können mehrdimensional sein, d. h. Elementtabellen entsprechen (erlaubt sind 1 bis 4 Dimensionen). In diesem Fall werden die Indizes als per Komma getrennte numerische Ausdrücke vorgegeben (Beispiel für eine gültige Syntax: M_TB(1,2,8)).

Klassen entsprechen einer Reihe von kontextabhängigen Variablen. Die folgenden Klassen kommen am häufigsten vor:

    [V]: Klasse der globalen Variablen. Globale Variablen sind an die X3-Sitzung gebunden. Nach der Anlage einer globalen Variable kann auf diese zugegriffen werden, solange sie nicht aufgelöst wird und so lange die X3-Sitzung läuft. Die Deklaration erfolgt mithilfe von speziellen Anweisungen (je nach Variablentyp Integer, Decimal, Char, Date, Libelle, Shortint, Float, Double).

    [L]: Klasse der lokalen Variablen Diese Klasse ist an eine Verschachtelung von Unterprogrammen gebunden (bei jeder Call -Anweisung wird eine neue Klasse von lokalen Variablen angelegt, die die vorherige Klasse verschattet). Lokale Variablen werden auf dieselbe Weise deklariert wie globale Variablen, der Deklaration muss jedoch das Schlüsselwort Localvorangestellt werden.

    [C]: Nummernkreisklassen Diese Variablen werden von allen Arbeitsplätzen eines Ordners gemeinsam genutzt. Sie werden von speziellen Entwicklungsfunktionen angelegt.

    [F:abv] oder [abv]: an eine mit der File-Anweisung deklarierte Tabelle gebundene Variablenklasse. Hier finden sich die Werte des aktuellen Datensatzes.

    [M:abv] oder [abv]: an eine mit der Mask-Anweisung erfasste Maske gebundene Variablenklasse. Hier finden sich die erfassten Werte und die möglichen Anzeigewerte (jedes Register auf einer Maske wird als Maske betrachtet).

Diese Klasse ist nicht obligatorisch, denn die Standardklasse kann mithilfe von Regeln ermittelt werden.

Daneben gibt es eine Reihe von so genannten Systemvariablen, die direkt von X3 verwaltet werden. Diese Variablen werden im Gegensatz zu den anderen Variablen bei der Erfassung nicht in Großbuchstaben umgewandelt, weil sie zu den Schlüsselwörtern zählen und daher in Kleinbuchstaben angezeigt werden. Hier einige Beispiele für verwendbare Systemvariablen (die Liste ist nicht vollständig):

In der Engine definierte Funktionen

Eine Funktion wird in Form von Funktion(Argumentliste) ausgedrückt. Es gibt sehr viele Funktionen: Verarbeitungen für Zeichenketten, Datumsberechnungen, klassische numerische Funktionen, Rundungs- und Abschneidefunktionen, statistische Funktionen etc.

Nachstehend eine Liste der wichtigsten in X3 verwendbaren Funktionen. Für die Funktionstabelle gelten folgende Notationskonventionen:

    v = Argument beliebigen Typs (analog v1, v2, v3 etc.)

    c = Argument vom Typ Zeichenkette

    x = numerisches Argument

    n, p, q etc. = ganzzahliges Argument

    V = Variable

    liste = Liste von Variablen oder Ausdrücken TABLO-Variablen (Typ Tabelle) können in diesen Listen im Format TABLO(I) (nur ein Index), TABLO (sämtliche Indizes werden durchlaufen) und TABLO(I...J) (die Indizes I bis einschließlich J werden durchlaufen) verwendet werden.

 Entwicklungsfunktionen

Darüber hinaus gibt es von den Entwicklern definierte Funktionen, die in Formeln verwendbar sind. Hierfür ist folgende Syntax zu verwenden:

func TRAIT.FONCT(Funktionsliste),

wobei TRAIT für den Verarbeitungsnamen und FONCT für den betreffenden Funktionsnamen steht. Die zur Verfügung stehenden Funktionen sind in der Unterprogrammtabelledokumentiert.