Berechnete Attribute

Berechnete Attribute sind schreibgeschützt.

Administratoren können den Attributabschnitten in den Aktionsdialogfeldern berechnete Attribute hinzufügen. Workflowbenutzer können sie in den Aktionsdialogfeldern und in Transaktionen anzeigen. Administratoren können den Zugriff auf bestimmte Rollen beschränken, indem Sie den Zugriff auf "Nicht anzeigen" setzen. Beispiel: Für das berechnete Attribut "XYZ" könnte ein Administrator den Zugriff "Leseberechtigter: Nicht anzeigen" hinzufügen, sodass XYZ Leseberechtigten nicht angezeigt würde.

Jede Benutzerrolle kann berechnete Attribute als Spalten in Ansichten und Listen hinzufügen. Sie können auch als filterbare Attribute in den Filtereinstellungen hinzugefügt werden.

In der folgenden Tabelle sind die Berechnungstypen aufgelistet, die jeder Attributtyp verwenden kann, wenn die Option "Berechnung" ausgewählt wird:

Table 4-1 Berechnungstypen, die jeder Attributtyp verwenden kann, wenn die Option "Berechnung" ausgewählt wird

Attributtyp Wert zu Liste zuweisen Bedingung Skript Liste zu Wert zuweisen
Datum     X  
Datum/Uhrzeit     X  
Ganzzahl X X X  
Liste   X   X
Mehrzeiliger Text X X X  
Zahl X X X  
Text X X X  
True/False   X    
Benutzer        
Ja/Nein   X    

Beispiele für Skriptfunktionen

Bei allen numerischen Funktionen werden bei der Berechnung des Ergebnisses alle Nullwerte in der Eingabe ignoriert.

  • Monat hinzufügen: Gibt einen Datumsversatz um eine angegebene Anzahl von Monaten ab den Startdatum zurück. Das Datum fällt immer in den angegebenen Monatsversatz. Wenn das Startdatum einen Tageswert angibt, der über die Tage in dem Versatzmonat hinausgeht, wird der letzte Tag des Versatzmonats verwendet. Beispiel: EDate (31-Jan-2017, 1) gibt (28-Feb-2017) zurück. Geben Sie bei Monaten die Anzahl von Monaten vor oder nach dem Startdatum ein. Ein positiver Wert für Monate ergibt ein zukünftiges Datum. Ein negativer Wert ergibt ein vergangenes Datum.

    EDate(<Start Date>, <Months>, <Length>)

    Beispiel: EDate(DATE(2017, 2, 15) 3)

  • Funktion Durchschnitt aus vorherigen Perioden: Errechnet den Durchschnitt eines numerischen Betrags aus den vorherigen X Perioden.

    AVERAGE_PRIOR(<Value>, <Number of Periods>, <To Currency*>, <Rate Type*>, <Rate Period*>

    Beispiel: AVERAGE_PRIOR( {Source System Balance (Reporting)}, '2', 'EUR', 'REC')

    Note:

    Parameter mit einem Stern, *, sind obligatorisch, wenn der Wert ein Saldenattribut ist, wie Quellsystem. Bei einem normalen Wert (wie einem numerischen Attribut) müssen die Parameter mit einem * weggelassen werden.

    Note:

    Kurstyp muss ein gültiger Kurstyp im System sein, oder der Wert 'REC', d.h., dass der Kurstyp verwendet wird, der der Abstimmung zugewiesen ist. Der Parameter "Kursperiode" muss 'CURRENT' oder 'PRIOR' sein, d.h. bei der Umrechnung der Währung werden die Kurstypen der aktuellen Periode oder der vorherigen Periode verwendet.

  • Datum: Gibt einen Datumswert basierend auf den angegebenen ganzzahligen Werten für Jahr, Monat und Tag zurück. Beispiel: Diese Funktion erstellt einen Wert des Typs "Datum", sodass DATE(2018, 5, 31) in 31. Mai 2018 konvertiert wird. Dieser kann dann in der Funktion "Datumsdifferenz" verwendet werden, um die Differenz in Tagen zwischen einem Datum, wie z.B. einem Enddatum, und diesem bestimmten Datum zu ermitteln.

    DATE(<Year>, <Month>, <Day>)

    Sie können auch die Datumsangaben PERIOD START, PERIOD END oder PERIOD CLOSE verwenden, wenn Sie ein berechnetes Datenattribut erstellen. Beispiel: Wenn Sie das Abschlussdatum einer Anpassungstransaktion mit dem Enddatum der Periode (PERIOD END) vergleichen möchten.

  • Datumsdifferenz: Gibt die Differenz zwischen zwei Daten in Tagen, Stunden, Minuten oder Sekunden zurück. Für Date1 und Date2 können die Werte 'TODAY' und 'NOW' verwendet werden, die das aktuelle Datum (ohne Zeitkomponente) und Datum/Uhrzeit angeben.

    Gültige Typen sind DAYS, HOURS, MINUTES, SECONDS.

    DATE_DIFF(<Date1>, <Date2>, <Type>)

    Beispiel: DATE_DIFF('TODAY', {Preparer End Date}, 'DAYS') oder DATE_DIFF({Preparer End Date}, 'NOW', 'HOURS')

  • Tag: Gibt den Tageswert eines Datums als Ganzzahl zurück

    DAY(<DATE>)

  • Text extrahieren: Gibt die Teilzeichenfolge innerhalb des Wertes von der angegebenen Position zurück. "Text extrahieren/Textposition" verwendet den Wert 1 für das erste Zeichen.

    SUBSTRING(<Value>, <Location>, <Length>)

    Beispiel: SUBSTRING( {Name} , 5, 10)

  • If/Then/Else: Ermöglicht dem Benutzer, eine Konditionalberechnung in die Skriptberechnung einzufügen. IF_THEN_ELSE-Berechnungen können auch verschachtelt werden, um Berechnungen des Typs "ELSE IF" zu unterstützen.

    IF_THEN_ELSE(<Condition>, <Value1>, <Value2>)

    Beispiel:

    IF_THEN_ELSE( {Risk Rating} = 'Low', 'Good',
IF_THEN_ELSE( {Risk Rating} = 'Medium', 'Better',
IF_THEN_ELSE({Risk Rating} = 'High', 'Best','Bad')))

  • Instring: Gibt den Index der Teilzeichenfolge innerhalb des Wertes zurück.

    INSTRING(<Value1>, <Value to Search>)

    Beispiel: INSTRING({Name}, 'a')

  • Länge: Verwendet einen Textwert als Parameter und gibt eine Ganzzahl zurück, bei der es sich um die Anzahl der Zeichen im Text handelt.

    LENGTH('Value') gibt 5 zurück, und LENGTH({Name}) würde die Anzahl der Zeichen im Namen des Objekts zurückgeben. Wenn der Wert leer/Null ist, gibt die Berechnung 0 zurück.

    Verwenden Sie die Berechnung mit SUBSTRING, um die letzten 4 Zeichen eines Textwertes zu extrahieren.

    Beispiel: SUBSTRING( {MyString}, LENGTH ({MyString}) - 4

  • Kleinbuchstaben: Gibt den Wert in Kleinbuchstaben zurück.

    LOWERCASE(<Value>)

    Beispiel: LOWERCASE( {Description} )

  • Maximum: Gibt den Höchstwert aus einer Liste mit Attributen zurück. Es kann eine beliebige Anzahl von Parametern vorhanden sein.

    MAX(<Value1>, <Value2>,<ValueN>)

    Beispiel: MAX( TRANSLATE( {Source System Balance (Entered)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Functional)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Reporting)}, 'USD', 'Accounting') )

  • Maximum über vorherige: Gibt den Höchstwert für die vorherigen X Perioden zurück.

    MAX_PRIOR (<Value>, <Number of Periods>, <To Currency*>, <Rate Type*>, <Rate Period*>)

    Beispiel: MAX_PRIOR( {Source System Balance (Functional)}, '6', 'CAD', 'REC', 'CURRENT')

    Note:

    Parameter mit einem Stern, *, sind obligatorisch, wenn der Wert ein Saldenattribut ist, wie Quellsystem. Bei einem normalen Wert (wie einem numerischen Attribut) müssen die Parameter mit einem * weggelassen werden.

    Note:

    Kurstyp muss ein gültiger Kurstyp im System sein, oder der Wert 'REC', d.h., dass der Kurstyp verwendet wird, der der Abstimmung zugewiesen ist. Der Parameter "Kursperiode" muss 'CURRENT' oder 'PRIOR' sein, d.h. bei der Umrechnung der Währung werden die Kurstypen der aktuellen Periode oder der vorherigen Periode verwendet.

  • Minimum: Gibt den Mindestwert aus einer Liste mit Attributen zurück. Es kann eine beliebige Anzahl von Parametern vorhanden sein.

    MIN(<Value1>, <Value2>,<ValueN>)

    Beispiel: MIN( TRANSLATE( {Source System Balance (Entered)}, 'CAD', 'REC'), TRANSLATE( {Source System Balance (Functional)}, 'CAD', 'REC'), TRANSLATE( {Source System Balance (Reporting)}, 'CAD', 'REC') )

  • Minimum über vorherige: Gibt den Mindestwert für die vorherigen X Perioden zurück.

    MIN_PRIOR (<Value>, <Number of Periods>, <To Currency*>, <Rate Type*>, <Rate Period*>)

    Beispiel: MIN_PRIOR( {Source System Balance (Functional)}, '6', 'EUR', 'Simplified')

    Note:

    Parameter mit einem Stern, *, sind obligatorisch, wenn der Wert ein Saldenattribut ist, wie Quellsystem. Bei einem normalen Wert (wie einem numerischen Attribut) müssen die Parameter mit einem * weggelassen werden.

    Note:

    Kurstyp muss ein gültiger Kurstyp im System sein, oder der Wert 'REC', d.h., dass der Kurstyp verwendet wird, der der Abstimmung zugewiesen ist. Der Parameter "Kursperiode" muss 'CURRENT' oder 'PRIOR' sein, d.h. bei der Umrechnung der Währung werden die Kurstypen der aktuellen Periode oder der vorherigen Periode verwendet.

  • Monat: Gibt den Monatswert eines Datums als Ganzzahl (1-12) zurück

    MONTH (<DATE>)

  • Potenz: Erhöht eine Zahl um den Exponenten einer anderen Zahl.

    POWER(x,y) wobei x=BASE NUMBER und y=EXPONENT. Dabei können x und y Attribute oder Berechnungen sein, sofern sie numerisch sind.

    Beispiel: POWER(3,4)=81

    Note:

    Brüche reduzieren die Zahl auf deren Root. Beispiel: POWER(27, 1/3) = 3 die Kubikwurzel.

    Note:

    Negative Werte kehren die exponentielle Berechnung um. Beispiel: POWER(2, -2) = 1 / (2^2) = 1 / 4 = .25.

  • Vorherige: Gibt den Wert für die angegebene vorherige Periode zurück. Wenn die Anzahl der vorherigen Perioden weggelassen wird, wird vom Wert 1 ausgegangen.

    PRIOR(<Value>, <Number of Periods Prior*>, <To Currency*>, <Rate Type*>, <Rate Period*>)

    Beispiel: PRIOR( {Source System Balance (Entered)}, '1', 'EUR', 'rec', 'prior')

    Note:

    Parameter mit einem Stern, *, sind obligatorisch, wenn der Wert ein Saldenattribut ist, wie Quellsystem. Bei einem normalen Wert (wie einem numerischen Attribut) müssen die Parameter mit einem * weggelassen werden.

    Note:

    Kurstyp muss ein gültiger Kurstyp im System sein, oder der Wert 'REC', d.h., dass der Kurstyp verwendet wird, der der Abstimmung zugewiesen ist. Der Parameter "Kursperiode" muss 'CURRENT' oder 'PRIOR' sein, d.h. bei der Umrechnung der Währung werden die Kurstypen der aktuellen Periode oder der vorherigen Periode verwendet.

  • Aufgerundet: Gibt den auf die angegebenen Dezimalstellen aufgerundeten Wert zurück.

    ROUND(<Value>, <Decimal Places>)

    Beispiel: ROUND( ({Scripted Translate} /7), 4)

  • Summe über vorherige: Gibt die Summe der Werte für die vorherigen X Perioden zurück.

    SUM_PRIOR(<Value>, <Number of Periods>, <To Currency*>, <Rate Type*>, <Rate Period*>)

    Beispiel: SUM_PRIOR( {Source System Balance (Reporting)}, '3', 'EUR', 'REC')

    Note:

    Parameter mit einem Stern, *, sind obligatorisch, wenn der Wert ein Saldenattribut ist, wie Quellsystem. Bei einem normalen Wert (wie einem numerischen Attribut) müssen die Parameter mit einem * weggelassen werden.

    Note:

    Kurstyp muss ein gültiger Kurstyp im System sein, oder der Wert 'REC', d.h., dass der Kurstyp verwendet wird, der der Abstimmung zugewiesen ist. Der Parameter "Kursperiode" muss 'CURRENT' oder 'PRIOR' sein, d.h. bei der Umrechnung der Währung werden die Kurstypen der aktuellen Periode oder der vorherigen Periode verwendet.

  • Textposition: Gibt den Index der Teilzeichenfolge innerhalb des Wertes zurück, angefangen mit 1 als der ersten Position.

    INSTRING(<Value>, <Value To Search>)

    Beispiel: INSTRING( UPPERCASE( {Name} ), 'TAX' )

  • Umrechnen: Rechnet ein Währungsattribut in ein numerisches Attribut mit dem angegebenen Kurstyp um.

    TRANSLATE(<Value>, <To Currency>, <Rate Type>)

    Beispiel: TRANSLATE( {Source System Balance (Entered)}, 'EUR', 'Accounting')

    Note:

    Kurstyp muss ein gültiger Kurstyp im System sein, oder der Wert 'REC', d.h., dass der Kurstyp verwendet wird, der der Abstimmung zugewiesen ist.

  • Großbuchstaben: Gibt den Wert in Großbuchstaben zurück.

    UPPERCASE(<Value>)

    Beispiel: UPPERCASE( {Name} )

  • Jahr: Gibt den Jahreswert eines Datums als Ganzzahl zurück

    YEAR (<DATE>)