Wertebereichs-Funktionen (CO, PF)

ABS: Absolutwert einer Zahl ermitteln

Ziel

• Absolutwert einer Zahl ermitteln

Information

• Die Funktion ABS liefert den Absolutwert einer Zahl. Der Absolutwert einer Zahl ist ihr Wert ohne das Vorzeichen.

Regel

• Syntax: ABS(Operand)

Beispiel

• Der Ausdruck ABS(-2) liefert den Wert 2.

ATOI: Umwandlung eines Strings in einen numerischen Wert

Ziel

• Umwandlung eines Strings (Typ X) in einen numerischen Wert

Regel

• ATOI (<Alphanumerisches DI, Variablen>)

Beispiel

Hinweis

• Hat der String keinen als Zahl interpretierbaren Inhalt, ist das Ergebnis von ATOI der Wert 0.

CONST: Konstanten in Wertebereichen

Ziel

• Holen einer Konstantenbezeichnung ggf. sprachabhängig

Regel

• CONST (Sprache, Konstanten-ID)

  • CONST: Funktion

  • Sprache: @19, 0000, 1000

  • Konstanten-ID: Identnummer der Konstante

Beispiel

Hinweis

• Die Bezeichnung der Konstante wird automatisch getrimmt.

EXIST: Existenzprüfung ohne Relationen

Informationen

• Wenn eine Prüfung über Relationen nicht möglich ist, kann ein Dataitem mit dieser Funktion trotzdem nach Existenz in der entsprechenden Datentabelle geprüft werden.

• Existiert ein entsprechender Datensatz nicht in der angegebenen DT, wird eine Benutzereingabe mit Bitte Eingabe überprüfen abgewiesen.

Regel

• EXIST (DI, DT)

  • EXIST: Funktion

  • DI: Ziel-DI, das geprüft werden soll (i.d.R. DI mit WB)

  • DT: DT in welcher nach Datensatzexistenz geprüft wird.

Beispiel

• Funktion EXIST mit Prüfung auf vorhandene Datensätze

• Funktion EXIST mit Prüfung auf nicht vorhandene Datensätze

Hinweis

• Die Prüfung

  • kann auf Idents, die sich aus einem DI bilden, erfolgen.

  • braucht nicht auf Ident-Dataitems selbst zu stehen, da diese sowieso über Relations-Funktion geprüft werden.

  • kann nur auf Idents vom DB-Typ = X zugreifen.

  • kann nicht auf zusammengesetzte Idents zugreifen.

EXP: Potenzieren von Zahlen

Ziel

• Potenzieren von Zahlen

Information

• Die Funktion EXP liefert potenzierte Werte einer Zahl.

Regel

• Syntax: EXP(Operand 1;Operand 2)

  • Operand 1 = Basis

  • Operand 2 = Exponent

Beispiel

• Der Ausdruck EXP(2;3) liefert den Wert 8.

• Der Ausdruck EXP(4;0.5) liefert den Wert 2.

• Der Ausdruck EXP(-3;3) liefert den Wert -27.

Hinweise

• Der Exponent darf keine rationale Zahl sein. Brüche wie z.B. ½ müssen durch den Wert 0.5 ersetzt werden.

• Bei Wurzeln aus positiven Zahlen wird nur das positive Ergebnis geliefert. Das Ergebnis von EXP(4;0.5) ist beispielsweise +2 und -2. Die Software liefert den Wert +2.

• Berechnungen mit negativer Basis sind nur mit ganzzahligem Exponenten zulässig. Berechnungen mit der Funktion EXP sollten daher nur nach der Umrechnung in einen Absolutwert durchgeführt werden.

Expand: Zurückgeben des Wertes einer Variablen

Ziel

• Auslesen des aktuellen Wertes einer Variablen

Beispiel

Hinweis

• Mögliche Variablen sind "@xxx", "@Gxxx", "@Dxxx", und "@Uxxx".

FMTDATE: Umwandlung eines Termin-DI in einen String

Ziel

• Umwandeln eines Termin-DIs in einen String z.B. um diesen in eine Zeichenketten einzubauen

Regel

• FMT(Termin-DI, <Format-ID>)

  • Termin-DI: Termin-Dataitem mit DB-Typ = N4

  • Format-ID:

    • Identnummer des Formats als Zeichenkette (mit "") oder

    • "" (Leerstring): Ausgabe im Standardterminformat der Benutzeroberfläche ( Format Termin)

FMT: Umwandlung eines numerischen DIs in einen String

Ziel

• Ein numerisches DI soll in einen String umgewandelt werden, um diesen z.B. in eine Zeichenkette einzubauen

Regel

• FMT(DI, <Formatstring>)

• Formatstring: &bdquo;[-][W][.P][e|E]"

  • -: links ausgerichtet (default: rechts)

  • W: min. Breite

  • P: max. Anzahl Nachkommastellen

  • E: Exponentialdarstellung

Beispiel

• Format → Resultat, Wert: 298.123

  • &bdquo;8.2" → &bdquo; 298.12"

  • &bdquo;-10" → &bdquo;298.12 "

  • &bdquo;.1" → &bdquo;298.1"

Hinweise

• Es sind alle numerischen DB-Typen erlaubt.

• Entspricht der UNIX-Funktion man fprintf.

FR: Zeichenkette anhängen

Ziel

• Holen eines Wertes eines Operanden und Anhängen von Zeichenketten vor und/oder hinter dem geholten Wert

Regel

• FR(<Zeichenkette>, <DIxxxxxx oder @xx>, <Zeichenkette>)

• Als Operanden können Dataitems und Variablen eingesetzt werden.

• Die Zeichenketten

  • können beliebig lang sein.

  • werden vorher getrimmt.

Hinweis

• Diese Funktion kann nicht für I-Texte eingesetzt werden.

IIFS: Werte nach Bedingung ermitteln

Ziel

• Zeichenketten in Abhängigkeit von Bedingungen unterschiedlich zusammenbauen

Regel

• IIFS (Bedingung, String1, String2)

  • Bedingung: logischer Ausdruck, dessen Ergebis WAHR oder FALSCH ist.

  • String1: Wert, den das prüfende DI annimmt, wenn die Bedingung erfüllt ist.

  • String2: Wert, den das prüfende DI annimmt, wenn die Bedingung nicht erfüllt ist.

Hinweise

• Die Anzahl der IIFS-Bedingungen in einer Wertebereichskonstruktion wurde auf 15 erhöht. Es dürfen bis 15 IIFS-Bedingungen angelegt werden.

• Gilt nur für X, AL Felder, aber nicht für Numerische.

LENGTH: Zeichenanzahl einer Zeichenkette ermitteln

Ziel

• Zeichenanzahl einer Zeichenkette ermitteln

Informationen

• Die Wertebereichsfunktion LENGTH liefert die Zeichenanzahl einer Zeichenkette.

• Leerzeichen am Anfang und Ende werden nicht mitgezählt.

Regel

• Syntax: LENGTH(Operand)

Beispiel

• Der Ausdruck LENGTH("12345678") liefert den Wert 8.

Hinweis

• Die Funktion kann nur auf Strings ( DB-Typ =X, Klasse =0) angewendet werden. Eine Anwendung auf I-Texte und Fließtexte ist nicht möglich.

NB: Eingabeprüfung für Alpha-Dataitem nach numerischer Regel (von, bis)

Informationen

• Ein alphanumerisches Dataitem wird in eine Zahl umgewandelt.

• Anschließend wird überprüft, ob diese Zahl zwischen von und bis liegt.

Regel

• NB (Dataitem, von, bis).

Beispiel

Hinweis

• Eine Eingabe wird mit der Fehlermeldung Bitte Eingabe überprüfen abgewiesen, wenn die Prüfung

  • keine gültige Zahl ergibt oder

  • die Zahl nicht im Bereich von/bis liegt.

NCHILD: Ausgabe der direkt untergeordneten Datensätze (veraltet)

Hinweis

• In 39 Umsetzung über Python-API

Information

• Diese Funktion gibt die Anzahl der direkt untergeordneten Datensätze aus dem ersten untergeordneten Datenbereich als N4 zurück.

Regel

• NCHILD()

Beispiel

NORMSINV: Quantile der Standardnormalverteilung

Information

• Die Funktion NORMSINV liefert die Quantile der Standardnormalverteilung.

Regel

• NORMSINV (Operand)

  • Der Operand ist die zur Standardnormalverteilung gehörige Wahrscheinlichkeit.

  • Ein Operand <0 oder >1 ist nicht zulässig.

Beispiel

• Der Ausdruck NORMSINV(0.75) liefert den Wert 0.674490.

OBS: Objektschutzüberschreibung

Ziel

• Überschreiben von Objektschutz-Dataitems mit dem angegebenen Wert

Beispiel

Regel

• OBS<OS-Teil > (Wert für Teil1, Wert für Teil2, ...)

  • OBS: Funktion

  • OS-Teil:

    • 1: Überschreibt (rwd owner, rwd group, rwd any)

      • Beispiel: OBS1 ("r--","r--","r--")

      • Ergebnis: Nach Export sind die Datensätze nicht mehr änder- bzw. löschbar

    • 2: Überschreibt (Anlagebenutzer [1-4],Anlagebenutzer [5-8])

      • Beispiel: OBS2 ("z", " ")

      • Ergebnis:

        • Nach Export haben die Datensätze den Anlagebenutzer "z".

        • In betreffenden Modulen kann nach "ohne z" gesucht werden. So werden die Datensätze mit Anlagebenutzer "z" nicht angezeigt und können nicht mehr geändert oder gelöscht werden.

Hinweise

• Diese Funktion

  • ist nur beim Export aus der PLANTA Software verwendbar.

  • wird virtuellen DIs mit DB-Typ X und DB-Länge = 2 in den betroffenen Datentabellen zugeordnet.

• Der Datenbereich, der die DIs mit diesen WB-Funktionen enthält, darf keine Datenfelder anderer Datentabellen enthalten.

• Die Datensätze werden direkt in den Datenbanken geändert. Dadurch werden

  • die zu ändernden Objektschutz-Datenfelder erst nach der Neusuche aktualisiert.

  • ggf. vorhandene Exits nicht ausgeführt.

PCT: Prozentabweichungsberechnung

Ziel

• Berechnung der prozentualen Abweichung zweier Dataitems

Regel

• PCT<DBTyp> (DI-1, DI-2)

  • PCT: Funktion

  • DB-Typ:

    • DB-Typ der in der Klammer angegebenen Dataitems.

    • Mögliche Werte: N2, N4, N8

  • DI-1: z.B. Ist-Wert

  • DI-2: z.B. Soll-Wert

Hinweise

• Diese Funktion kann nur zwischen DIs mit gleichen DB-Typ angewendet werden.

• Wenn eine %-Abweichung zwischen DIs mit unterschiedlichen DB-Typen angewendet werden soll, muss

  • ein DI mit WB-Art =CS eines der beiden DB-Typen umgewandelt werden.

  • diese Werteberechnung in jedem Fall mit der WB-Art =CO durchgeführt werden.

PERIOD: Zeitraumermittlung

Ziel

• Ermittlung des Anfangs- oder Endtermins eines Zeitraums relativ zu einem Datum

Information

• Funktion zur Zeitraumermittlung:

  • Ergebnis

    • Ein Tagesdatum, das den ersten oder letzten Tag des durch die Eingabeparameter der Funktion festgelegten Zeitraums darstellt.

  • Verwendungsmöglichkeiten

    • Anfangs- und Endtermin in Zeitskalen

    • Anfangs- und Endtermin in Terminbalken

    • Als dynamische Variable für Filterkriterien

    • Als dynamische Variable in Wertebereichen

Details

• Ausgehend von einem angegebenen Datum soll vom System der Anfangs- oder Endtermin des Zeitraums ermittelt werden, in dem dieses Datum liegt oder eines benachbarten Zeitraums:

  • Kalenderwoche des Datums

  • n-te Woche davor (nicht implementiert)

  • n-te Woche danach (nicht implementiert)

  • Monat des Datums

  • n-ter Monat davor

  • n-ter Monat danach

  • Quartal des Datums

  • n-tes Quartal davor

  • n-tes Quartal danach

  • Jahr des Datums

  • n-tes Jahr davor

  • n-tes Jahr danach

Regel

• PERIOD (<Datum>, <Raster>, <Terminlage>, <Abstand>)

  • Datum

    • Auf dieses Datum bezieht sich der ermittelte Zeitraum.

    • Als Wert kann ein Datums-Dataitem verwendet werden oder eine dynamische, globale, Benutzer- oder Systemvariable, die ein Datum enthält.

  • Raster

    • Legt fest, für welchen Zeitraum der Anfangs- oder Endtermin ermittelt wird.

    • Werte:

      • 3: Woche

      • 4: Monat

      • 5: Quartal

      • 6: Jahr

  • Terminlage

    • Werte:

      • 0: der Anfangstermin wird ermittelt

      • 1: der Endtermin wird ermittelt

    • Es kann ein Dataitem mit DB-Typ=N2 verwendet werden oder eine Benutzervariable oder eine dynamische, globale Variable, die den Wert 0 oder 1 enthält.

  • Abstand

    • Legt fest, der wievielte Zeitraum davor bzw. danach ermittelt wird.

    • Werte:

      • 0: der Zeitraum, in dem das Datum selbst liegt

      • < 0: Anzahl gleicher Zeiträume davor

      • > 0: Anzahl gleicher Zeiträume danach

    • Es kann ein Dataitem mit DB-Typ=N2 verwendet werden oder eine Benutzervariable oder eine dynamische, globale Variable, die eine Ganzzahl enthält.

Beispiele

RELPOS: Ausgabe der Datensatzposition

Information

• Diese Funktion gibt die relative Position des Datensatzes in der Datentabelle als N4 zurück.

Hinweis

• Funktion funktioniert nicht in Modulen mit Struktursortierung.

ROUND: Zahlen runden

Information

• Die Funktion ROUND rundet eine Zahl auf eine definierbare Anzahl von Stellen, z.B liefert der Ausdruck ROUND(12,3456;2) den Wert 12.35.

Regel

• Syntax: ROUND(<Wert>;<Anzahl Dezimalstellen>).

STR: Abschneiden von Zeichenketten

Ziel

• Holen eines Wertes eines Operanden und Abschneiden von Zeichenketten an beliebiger Stelle

Regel

• STR(<DIxxxxxx oder @xx>, Startposition, Länge)

  • Als Operanden können Dataitems und Variablen eingesetzt werden.

  • Startposition

    • Stelle in der Zeichenkette des Operanden, ab welcher abgeschnitten wird.

    • ab der ersten Stelle der Operanden nach oben gezählt wird.

  • Länge

    • Anzahl Zeichen, die ab Startposition abgeschnitten werden.

    • max. Länge ist Länge der Operanden

Beispiel

SYSTEM: Programmaufruf von der Software aus

Informationen

• Diese Funktion soll nicht mehr verwendet werden.

• Diese Funktion erlaubt den Aufruf eines anderen Programms vom Programm aus.

• Die Ausführung dieses Programms geschieht synchron, d.h. das System wartet, bis das aufgerufene Programm beendet ist.

Regel

• SYSTEM(DI<DI-Nummer>)

  • DI<Nummer>: das DI enthält das Kommando, wie bei einer Shell-Eingabe, z. B. &bdquo;cp file1 file2 1>&2 2> cp.err$$".

  • Um nur auf Fehler zu prüfen, wird hinter der Klammer der Vergleichoperand angehängt, z.B.: SYSTEM( DI<DI-Nummer>) 0

Hinweise

• Die Funktion SYSTEM gibt bei Erfolg den Wert Null zurück; sie sollte daher an ein DI vom internen Typ Integer gebunden werden. Zur Angabe des auszuführenden Programms ist ein Text-DI erforderlich, welches Name und Optionen des Programms aufnimmt.

• Wenn dieser Wertebereich an ein J/N-Feld mit Bezeichnung Fehler gebunden ist, erfolgt die Anzeige des Status als Text.

• Der neue Prozess übernimmt Standardeingabe und -ausgabe des Systems und ist daher direkt mit dem Programm-Client verbunden. Ausgaben würden also zum Client gesendet, daher müssen Standardeingabe, -ausgabe und -fehler umgeleitet werden.

• Der Rückgabewert von SYSTEM entspricht dem Return-Status (integer) des aufgerufenen Programms.

• Zur Unterscheidung von bei der Ausgabeumleitung erzeugten Dateien kann &bdquo;$$" in den Namen eingefügt werden. Die beiden Zeichen werden bei der Ausführung durch die Prozessnummer ersetzt.

TRIM: Leerzeichen entfernen

Ziel

• Leerzeichen vor und/oder nach einer Zeichenkette entfernen

Regel

• TRIM (Operand)

  • TRIM: Funktion

  • Operand: DI, Variablen- oder Konstanten-Identnummer

VH: Anzahl Datensätze in einer untergeordneten Datentabelle

Information

• Diese Funktion zeigt die Anzahl von Datensätzen eines übergeordneten Datensatzes an, die in einer untergeordneten Datentabelle existieren, ohne dass ein Datenbereich dieser Datentabelle im Modul existieren muss.

Regel

• VH (DT, Index, Pfad, DI)

  • DT: Zieldatentabelle, deren Verwendungshäufigkeit ermittelt werden soll

  • Index: Angegebene Datentabelle im Ident der Ziel-DT

  • Pfad: abhängig vom Variablennamen aus Relation

    • 0: z.B. "ID425"

    • 1: z.B. "ID425A"

    • 2: z.B. "ID425B"

    • 3: z.B. "ID425C"

  • DI: Ident-DI in der Datentabelle des übergeordneten Objekts, mit dem in der untergeordneten gesucht werden soll.

Hinweis

• Diese Funktion kann mit den WB-Arten: CS, CO, und CL angewendet werden.

Achtung

• Wird der Wertebereich falsch konstruiert, tritt im Modul bei der Suche die Fehlermeldung Datenbankfehler -52 auf, die für jeden gefundenen Datensatz bestätigt werden muss.

IKV: EXCEL-Funktion für finanzmathematische Berechnungen

Ziel

• Einsatz der EXCEL-Funktion IKV als Wertebereichsfunktion in der PLANTA Software, um finanzmathematische Berechnungen mit Programm-Customizing zu realisieren.

Regelen

• IKV (Wert1,Wert2,Wert3,....,Wert12,Schätzwert)

• Algorithmus: MS EXCEL, Funktion IKV

• Eingabe-Parameter

  • Wert1 bis Wert12

    • Werte der Zahlungsreihe als Kosten (negativ) und Nutzen (positiv) in der Reihenfolge der Jahre.

    • Es muss mindestens einen negativen und einen positiven Wert geben.

    • Operatoren für Wert1 bis Wert12 können sein:

      • DIxxxxxx (numerische Dataitems, DBTyp = N8)

      • @Dxxxx (dyn. Variablen auf numerischen Dataitems, DBTyp = N8)

      • numerische Konstanten, z.B. 0.0

    • Wenn weniger als 12 Werte benötigt werden, können die restlichen Parameter konstant mit 0.0 im Wertebereich angegeben werden.

  • Schätzwert

    • siehe EXCEL-Hilfe

    • 0, wenn nicht verwendet. Dann nimmt das System intern &bdquo;10%" an, siehe EXCEL-Funktion

  • Rückgabewert

    • Ergebnis von EXCEL-IKV

    • 999999.99, wenn Berechnung nicht durchgeführt werden kann (bei Excel: #ZAHL!)

Beispiel

• IKV(DI299101, DI299102, DI299103, DI299104, DI299105, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)

Hinweis

• Der Wertebereich soll nicht mit Wertebereichsart CO verwendet werden, weil dann nach jeder Eingabe eines an der Formel beteiligten Feldes sofort eine Neuberechnung des IKV-Wertes stattfindet, was wegen des verwendeten Iterationsverfahrens dauern kann.

Abstands- und Terminberechnung

Ziel

• Berechnen von Daten bzw. Abständen zwischen zwei Terminen über einen in der PLANTA Software hinterlegten Kalender

Details: Ermittlung der Anzahl von Werktagen

• Berechnung der Anzahl von Werktagen zwischen zwei Terminen

  • Um die Anzahl Werktage zwischen zwei Terminen auszurechnen, wird folgende Formel benutzt:

    • WD_BETWEEN([Kalender],[Termin1],[Termin2])

Beispiel 1

• Anzahl der Arbeitstage zwischen Heute und Heute + 100 Tage im Kalender &bdquo;BK"

• Ergebnis:

  • WD_BETWEEN("BK",@15,@15+100)

Beispiel 2

• Anzahl der Arbeitstage zwischen dem 01.01.1970 und Heute im Kalender &bdquo;BK"

• Ergebnis:

  • WD_BETWEEN("BK",0,@15)

Details: Datumsermittlung

• Datumsermittlung über Werktage

  • Zur Berechnungen mit einer Anzahl von Werktagen wird folgende Formel verwendet:

    • WD_TIMEINTERVAL([Kalender],[Starttermin],[Anzahl])

Beispiel 1

• Datum von Heute + 5 Arbeitstage, welche im Kalender &bdquo;BK" hinterlegt sind.

• Ergebnis:

  • WD_TIMEINTERVAL("BK",@15,5)

Beispiel 2

• Datum von Heute + die Anzahl der Arbeitstage aus DI000002+1, welche im Kalender aus DI000001 hinterlegt sind.

• Ergebnis:

  • WD_TIMEINTERVAL(DI000001,@15,(DI000002+1))