MARINI Logo
Help Center
Erste Schritte
HubEngine
DataEngine
Record Linkage
Weitere Ressourcen
Support kontaktieren

Calculated Fields Workflow Action

In diesem Beitrag erfährst du alles über die Workflow Action „Calculated Fields“ und wie du sie effektiv nutzen kannst, um Berechnungen anzustellen, Texte zu identifizieren und Daten zu formatieren.

Was sind Calculated Fields?

Diese Funktion basiert auf einem definierten Formelwerk, das dir ermöglicht, komplexe Transformationen vorzunehmen. Sie besteht aus drei zentralen Bestandteilen: Parameter, Relation Parameter und Formulas.

1. Parameter

Parameter sind die Felder des Workflow-Moduls, die du für deine Berechnungen verwenden kannst. Diese Parameter werden in Formeln nach dem Schema `{P0}` eingebunden. Sobald du einen neuen Parameter hinzufügst, wird im Interface angezeigt, welchen Parameter das betreffende Feld hat. So hast du immer die volle Kontrolle darüber, wie die Daten in deinen Berechnungen verwendet werden.

2. Relation Parameter

Mit Relation Parameter erhältst du Zugriff auf alle 1-zu-viele-Beziehungen des Moduls und deren Felder. Diese werden in Formeln nach dem Schema `{R0}` eingebunden. Dadurch kannst du Daten aus in Beziehung stehenden Datensätzen auswerten und berücksichtigen. Das gibt dir die Möglichkeit, komplexere Datenanalysen und Transformationen durchzuführen.

3. Formulas

Unter Formulas legst du die konkrete Formel fest, die auf ein bestimmtes Feld angewendet werden soll. Du wählst zunächst das entsprechende Feld aus und gibst dann die Formel in der Textzeile ein. Du kannst mehrere Formeln ineinander verschachteln oder hintereinander verketten. Um dies zu tun, füge einfach eine weitere Formel anstelle eines Parameter-Teils in einer anderen Formel ein oder hänge eine neue Formel an deine vorherige Formel an. Wichtig ist, darauf zu achten, dass die Notation korrekt ist, da sonst die Auswertung fehlschlagen könnte.

4. Escaping Semikolon (Neu ab DataEngine 25.03.1-beta3)

Warum wird ein Escape-Semikolon benötigt?

In der DataEngine dient das Semikolon (;) als Trennzeichen für Parameter in Formeln. Das bedeutet, dass bei der Eingabe einer Formel wie: {position(subject; search; occurrence)} die Semikolons die einzelnen Parameter innerhalb der Formel voneinander abgrenzen.

Es gibt jedoch Situationen, in denen ein Semikolon als Teil eines Wertes verwendet werden muss, ohne dass es als Trennzeichen interpretiert wird. Für solche Fälle gibt es das spezielle Escape-Semikolon \;.

So verwendest du das Escape-Semikolon

Um ein Semikolon innerhalb eines Wertes korrekt einzufügen, ohne dass es die Formelstruktur stört, muss das Escape-Semikolon \; verwendet werden. Ein Beispiel mit dem Escape-Mechanismus innerhalb der vorherigen Formel:

{position(subject; \; ; occurrence)}

Hier sorgt das Escape-Semikolon \; dafür, dass das System das Semikolon als Teil des Wertes interpretiert und nicht als Trennzeichen der Formel. Dadurch wird sichergestellt, dass die Formel die Position des Semikolons innerhalb des subject-Texts korrekt ermittelt.

Unterstützte Formel-Kategorien

  1. Logische Funktionen: Diese liefern die Werte 0 oder 1 und sind ideal für Abgleiche wie „gleich“ oder „größer gleich“.
  2. Textfunktionen: Verwende diese, um Texte in unterschiedlichen Formen zu transformieren.
  3. Mathematische Funktionen: Nutze alle gängigen mathematischen Operationen, um Zahlen zu transformieren.
  4. Datumsfunktionen: Diese sind nützlich, um Datumswerte zu transformieren oder aufgrund bestimmter Bedingungen festzulegen.
  5. Kontroll-Funktionen: Mit der ifThenElse-Funktion kannst du komplexe Abfragen und Bedingungsprüfungen durchführen. Verschachtelungen sind hier möglich, um mehrere Bedingungen zu berücksichtigen.
  6. Counter Funktionen: Diese Funktionen zählen Datensätze innerhalb des Systems und fügen ihnen Zähler hinzu.
  7. JSON-Funktionen: JSON Arrays können nach bestimmten Regeln transformiert und spezifische Werte extrahiert werden.
  8. PHP-Funktionen: Diese Funktionen können genutzt werden, um PHP Arrays zu transformieren.

Mit dieser Übersicht bist du bestens gerüstet, um die Calculated Fields in deinen Workflows optimal einzusetzen.

Logische Funktionen

Logische Funktionen geben true oder false in Form von 1 und 0 zurück, sodass Checkbox-Felder mit diesen Funktionen gefüllt werden können. Sie können auch als logische Bedingung für die ifThenElse-Funktion verwendet werden.

equal

Formel {equal(parameter1;parameter2)}
Parameter parameter1: kann ein beliebiger Wert eines beliebigen Typs sein
parameter2: kann ein beliebiger Wert eines beliebigen Typs sein
Beschreibung Prüft ob parameter1 gleich parameter2 ist
Ergebnis 1, wenn die Parameter gleich sind 0, wenn nicht
Beispiel {equal(1; 2)} Ergebnis 0

notEqual

Formel {notEqual(parameter1; parameter2)}
Parameter parameter1: kann ein beliebiger Wert eines beliebigen Typs sein
parameter2: kann ein beliebiger Wert eines beliebigen Typs sein
Beschreibung Prüft ob parameter1 ungleich parameter2 ist
Ergebnis 0, wenn die Parameter gleich sind 1, wenn nicht
Beispiel {notEqual(1; 2)} Ergebnis 1

greaterThan

Formel {greaterThan(parameter1; parameter2)}
Parameter parameter1: kann ein beliebiger Wert eines beliebigen Typs sein
parameter2: kann ein beliebiger Wert eines beliebigen Typs sein
Beschreibung Prüft ob parameter1 größer als parameter2 ist
Ergebnis 1,wenn parameter1 größer als parameter2 ist, 0, wenn nicht
Beispiel {greaterThan(3; 3)} Ergebnis 0

greaterThanOrEqual

Formel {greaterThanOrEqual(parameter1; parameter2)}
Parameter parameter1: kann ein beliebiger Wert eines beliebigen Typs sein
parameter2: kann ein beliebiger Wert eines beliebigen Typs sein
Beschreibung Prüft ob parameter1 größer oder gleich parameter2 ist
Ergebnis 1, wenn parameter1 größer oder gleich parameter2 ist, 0, wenn nicht
Beispiel {greaterThanOrEqual(3; 3)} Ergebnis 1

lessThan

Formel {lessThan(parameter1; parameter2)}
Parameter parameter1: kann ein beliebiger Wert eines beliebigen Typs sein
parameter2: kann ein beliebiger Wert eines beliebigen Typs sein
Beschreibung Prüft ob parameter1 kleiner als parameter2 ist
Ergebnis 1, wenn parameter1 kleiner als parameter2 ist, 0, wenn nicht
Beispiel {lessThan(3; 3)} Ergebnis 0

lessThanOrEqual

Formel {lessThanOrEqual(parameter1; parameter2)}
Parameter parameter1: kann ein beliebiger Wert eines beliebigen Typs sein
parameter2: kann ein beliebiger Wert eines beliebigen Typs sein
Beschreibung Prüft ob parameter1 kleiner oder gleich parameter2 ist
Ergebnis 1, wenn parameter1 kleiner oder gleich parameter2, 0, wenn nicht
Beispiel {lessThanOrEqual(3; 3)} Ergebnis 1

empty

Formel {empty(parameter)}
Parameter parameter: Text
Beschreibung Prüft ob parameter leer ist
Ergebnis 1, wenn parameter leer ist, 0, wenn nicht
Beispiel {empty(beliebiger Text)} Ergebnis 0

notEmpty

Formel {notEmpty(parameter)}
Parameter parameter: Text
Beschreibung Prüft ob parameter ungleich leer ist
Ergebnis 1, wenn parameter nicht leer ist, 0, wenn leer
Beispiel {notEmpty(beliebiger Text)} Ergebnis 1

not

Formel {not(parameter)}
Parameter parameter: Logikwert
Beschreibung Negiert the Logikwert von parameter
Ergebnis 1, wenn parameter ist 0, 0, wenn parameter ist 1
Beispiel {not(0)} Ergebnis 1

and

Formel {and(parameter1; parameter2)}
Parameter parameter1: Logikwert
parameter2: Logikwert
Beschreibung Fügt den UND Logik-Operator zu zwei Logikwerten hinzu
Ergebnis 1, wenn parameter1 and parameter2 gleich 1 sind, 0, wenn einer der Parameter 0 ist
Beispiel {and(1; 0)} Ergebnis 0

or

Formel {or(parameter1; parameter2)}
Parameter parameter1: Logikwert
parameter2: Logikwert
Beschreibung Fügt den ODER Logik-Operator zu zwei Logikwerten hinzu
Ergebnis 1, wenn parameter1 oder parameter2 gleich 1 ist, 0, wenn beide Parameter gleich 0 sind
Beispiel {or(1; 0)} Ergebnis 1

Textfunktionen

Textfunktionen werden verwendet, um Text auf verschiedene Weise zu transformieren. Alle hier aufgeführten Funktionen unterstützen UTF-8-Texte vollständig, sodass Sonderzeichen keine Probleme verursachen sollten.

substring

Formel {substring(text; start; length)}
Parameter text: Text
start: Dezimalzahl
length (Optional): Dezimalzahl
Beschreibung Schneidet die Teilzeichenkette eines Textfeldes vom Anfang an aus. Wenn der optionale Parameter length nicht gesetzt ist, werden alle Zeichen bis zum Ende der Zeichenkette abgeschnitten, andernfalls wird die angegebene Länge abgeschnitten. Indizierung der Zeichen eines Textes beginnend bei 0.
Ergebnis Teilzeichenkette des gegebenen Texts
Beispiel {substring(Das ist mein Text; 4)} Ergebnis ist mein Text
{substring(Das ist mein Text; 4; 8)} Ergebnis ist mein

length

Formel {length(parameter)}
Parameter parameter: Text
Beschreibung Zählt die Zeichen eines Texts.
Ergebnis Die Anzahl der Zeichen eines Texts.
Beispiel {length(Beispiel Text)} Ergebnis 13

replace

Formel {replace(search; replace; subject)}
Parameter search: Text
replace: Text
subject: Text
Beschreibung Ersetzt alle Erscheinungen von search zu replace in subject
Ergebnis subject mit ersetzten Werten.
Beispiel {replace(Apfel; Orangen; Das ist ein Apfelbaum)} Ergebnis Das ist ein Orangenbaum

position

Parameter „occurence“ neu ab DataEngine 25.03.1-beta3

Formel {position(subject; search; occurrence)}
Parameter subject: Text in dem gesucht wird
search: Text nach dem gesucht wird
occurence (optional): Numerischer Wert, der angibt, wie viele gefundene Werte übersprungen werden sollen, bevor eine Position zurückgegeben wird.
Beschreibung Gibt die Position des ersten gefundenen Werts von search in subject zurück. Wenn occurrence angegeben ist, gibt die Funktion die Position des (occurrence+1)-ten Werts von search zurück. Existiert der angegebene Wert nicht, wird -1 zurückgegeben.
Ergebnis Zahlenposition von search in subject oder -1, wenn search in subject nicht vorhanden ist
Beispiel {position(Wo ist mein Text?; Text)} Ergebnis 12

lowercase

Formel {lowercase(parameter)}
Parameter parameter: Text
Beschreibung Wandelt den Text in Kleinbuchstaben
Ergebnis Der Text in Kleinbuchstaben
Beispiel {lowercase(DaS iSt EiN BeiSpIelTexT)} Ergebnis das ist ein beispieltext

uppercase

Formel {uppercase(parameter)}
Parameter parameter: Text
Beschreibung Wandelt den Text in Großbuchstaben
Ergebnis Der Text in Großbuchstaben
Beispiel {uppercase(DaS iSt EiN BeiSpIelTexT)} Ergebnis DAS IST EIN BEISPIELTEXT

uppercaseword

Neu ab DataEngine 24.11.1

Formel {uppercaseword(parameter)}
Parameter parameter: String oder Text. Kann auch eine Variable sein: {P0}
Beschreibung Wandelt den ersten Buchstaben aller Wörter einer Zeichenfolge in Großbuchstaben um. Wandelt alle anderen Buchstaben in Kleinbuchstaben um.
Ergebnis Die Zeichenfolge mit dem jeweils ersten Buchstaben eines Wortes als Großbuchstabe.
Beispiel {uppercaseword(DIES IST EIN TEXT MIT LAUTER GROSSBUCHSTABEN)} ergibt Dies Ist Ein Text Mit Lauter Grossbuchstaben

Base64Encode

Formel {Base64Encode(parameter1)}
Parameter parameter1: Die zu kodierende Zeichenfolge
Beschreibung Kodiert eine Zeichenfolge in Base64.
Ergebnis Die Base64-kodierte Zeichenfolge.
Beispiel {Base64Encode(abc)} – Kodiert die Zeichenfolge abc in Base 64.

Base64Decode

Formel {Base64Decode(parameter1)}
Parameter parameter1: Die zu dekodierende base64-kodierte Zeichenfolge
Beschreibung Dekodiert eine base64-kodierte Zeichenfolge.
Ergebnis Die dekodierte Zeichenfolge.
Beispiel {Base64Decode(„YWJj“)} – Dekodiert die base64-kodierte Zeichenfolge YWJj zu abc.

Mathematische Funktionen

Mathematische Funktionen werden verwendet, um Zahlen auf verschiedene Weise zu transformieren. Mehrere mathematische Operatoren sind in Calculated Fields als Funktionen implementiert.

add

Formel {add(parameter1; parameter2)}
Parameter parameter1: Zahlenwert
parameter2: Zahlenwert
Beschreibung Addiert parameter1 zu parameter2 hinzu
Ergebnis Die Summe von parameter1 und parameter2
Beispiel {add(3.12; 4.83)} Ergebnis 7.95

subtract

Formel {subtract(parameter1; parameter2)}
Parameter parameter1: Zahlenwert
parameter2: Zahlenwert
Beschreibung Zieht parameter2 von parameter1 ab
Ergebnis Die Differenz von parameter2 und parameter1
Beispiel {subtract(8; 3)} Ergebnis 5

multiply

Formel {multiply(parameter1; parameter2)}
Parameter parameter1: Zahlenwert
parameter2: Zahlenwert
Beschreibung Multipliziert parameter1 und parameter2
Ergebnis Das Produkt von parameter1 und parameter2
Beispiel {multiply(2; 4)} Ergebnis 8

divide

Formel {divide(parameter1; parameter2)}
Parameter parameter1: Zahlenwert
parameter2: Zahlenwert
Beschreibung Teilt parameter1 durch parameter2
Ergebnis Die Division von parameter1 und parameter2
Beispiel {divide(8; 2)} Ergebnis 4

power

Formel {power(parameter1; parameter2)}
Parameter parameter1: Zahlenwert
parameter2: Zahlenwert
Beschreibung Potenziert parameter1 um die Anzahl von parameter2
Ergebnis parameter1 potenziert um die Anzahl von parameter2
Beispiel {power(2; 7)} Ergebnis 128

squareRoot

Formel {squareRoot(parameter)}
Parameter parameter: Zahlenwert
Beschreibung Zieht die Wurzel von parameter
Ergebnis Die Wurzel von parameter
Beispiel {squareRoot(4)} Ergebnis 2

absolute

Formel {absolute(parameter)}
Parameter parameter: Zahlenwert
Beschreibung Berechnet den absoluten Wert von parameter
Ergebnis Der absolute Wert von parameter
Beispiel {absolute(-4)} Ergebnis 4

sum

Neu ab DataEngine 25.01.1

Formel {sum(BeanID;RelatedModule;Field;FilterField;FilterOperator;FilterValue)}
Parameter BeanID: ID des Beans, von dem aus gestartet wird.
RelatedModule: Name der Beziehung wie im Studio definiert. Mehrere Beziehungen können mittels :: verknüpft werden (Von Kontakt zu Firma, Von Firma zu Rechnung). Kann leer sein, um alle Einträge in der Modultabelle zu summieren.
Field: Name des zu summierenden Feldes aus dem zuletzt genannten „RelatedModule“.
FilterField(Optional): Ein beliebiges Feld aus dem zuletzt genannten „RelatedModule“, das für die Filterung verwendet wird.  Falls der Parameter ein Datum/Zeit Feld ist, wird der angegebene Wert automatisch in ein Datum umgewandelt.
FilterOperator (Optional): Ein Operator für die Filterung. Mögliche Operatoren sind Less than (lt), Less than or equal (lte), Greater than (gt), Greater than or equal (gte), Equal (eq), Not equal (neq).
FilterValue (Optional): Ein Wert gegen den das FilterField verglichen wird mit dem entsprechenden FilterOperator.
Beschreibung Summiert die Werte der Einträge, die mit dem angegebenen Bean in Beziehung stehen. Es ist möglich, die Summierung basierend auf einem Feld im zugehörigen Modul zu filtern, beispielsweise für „Nur Rechnungen der letzten 2 Jahre“.
Ergebnis Summe aller Werte
Beispiel {sum({P0};core_accounts_core_contracts;contract_volume;last_invoice;gt;{subtractYears(Y-m-d;{now(Y-m-d)};2)})} – Summiert das Vertragsvolumen der Verträge des aktuellen Accounts, die in den letzten zwei Jahren eine Rechnung erhalten haben.

count

Neu ab DataEngine 25.01.1

Formel {count(BeanID;RelatedModule;Field;FilterField;FilterOperator;FilterValue)}
Parameter BeanID: ID des Beans, von dem aus gestartet wird.
RelatedModule: Name der Beziehung wie im Studio definiert. Mehrere Beziehungen können mittels :: verknüpft werden (Von Kontakt zu Firma, Von Firma zu Rechnung). Kann leer sein, um alle Einträge in der Modultabelle zu zählen.
Field: Name des zu zählenden Feldes, beispielsweise id. Wenn hier ein anderes Feld als „id“ angegeben wird, wird überprüft, ob dieses Feld nicht leer ist. Dadurch kann ein anderes Ergebnis als das Zählen über „id“ zurückgegeben werden. Das Feld muss aus dem zuletzt genannten „RelatedModule“ stammen.
FilterField(Optional): Ein beliebiges Feld aus dem zuletzt genannten „RelatedModule“, das für die Filterung verwendet wird.  Falls der Parameter ein Datum/Zeit Feld ist, wird der angegebene Wert automatisch in ein Datum umgewandelt.
FilterOperator (Optional): Ein Operator für die Filterung. Mögliche Operatoren sind lt, lte, gt, gte, eq, neq.
FilterValue (Optional): Ein Wert gegen den das FilterField verglichen wird mit dem entsprechenden FilterOperator.
Beschreibung Zählt die Einträge, die mit dem angegebenen Bean in Beziehung stehen. Es ist möglich, die Zählung basierend auf einem Feld im zugehörigen Modul zu filtern, beispielsweise für „Nur Rechnungen der letzten 2 Jahre“. Falls ein Feld angegeben ist, darf dieses nicht leer sein.
Ergebnis Anzahl der Ergebnisse.
Beispiel {count({P0};core_accounts_core_contracts;contract_volume;last_invoice;gt;{subtractYears(Y-m-d;{now(Y-m-d)};2)})} – Zählt die Verträge des aktuellen Accounts mit nicht leerem Volumen, die in den letzten zwei Jahren eine Rechnung erhalten haben.

floor

Neu ab DataEngine 25.01.1-beta1

Formel {floor(parameter)}
Parameter parameter: Zahlenwert
Beschreibung Rundet den Zahlenwert in parameter auf die nächst kleinere Zahl.
Ergebnis Der gerundete Wert von parameter.
Beispiel {floor(3.1415)} Ergebnis 3

ceil

Neu ab DataEngine 25.01.1-beta1

Formel {ceil(parameter)}
Parameter parameter: Zahlenwert
Beschreibung Rundet den Zahlenwert von parameter auf die nächst größere Zahl.
Ergebnis Der gerundete Wert von parameter.
Beispiel {floor(3.1415)} Ergebnis 4

round

Neu ab DataEngine 25.01.1-beta1

Formel {round(parameter1; parameter2; parameter3)}
Parameter parameter1: Zahlenwert
parameter2 (optional): Anzahl an Nachkommastellen
parameter3 (optional): Rundungsregel (was passiert mit ,5) mit folgenden Optionen: down = strikt ab; up = strikt hoch; even= zur nächsten geraden Ganzzahl; odd = zur nächsten ungeraden Ganzzahl
Beschreibung Rundet die aktuelle Zahl auf den nächsten Wert, basierend auf den in parameter2 und parameter3 eingegebenen Regeln. Sind die Parameter 2 und 3 nicht gesetzt, wird die Zahl mit zwei Dezimalstellen abgerundet.
Ergebnis Der gerundete Wert von parameter1.
Beispiel {round(3.1415; 3; up)} Ergebnis 3,142

Datumsfunktionen

Es gibt mehrere Datumsfunktionen, die in Calculated Fields implementiert sind, sodass der Benutzer Daten auf vielfältige Weise transformieren kann. Die meisten Funktionen verwenden einen Format-Parameter, mit dem das Ergebnis der Funktionen nach den Wünschen des Benutzers formatiert wird. Die Optionen für diese Formate entsprechen den PHP-Formatparametern (bei textlicher Darstellung ist das Ergebnis immer der englische Wert):

Für Tage

Formelzeichen Beschreibung Beispiel Ergebnis
d Tag des Monats, 2 Ziffern mit führenden Nullen 01 bis 31
D Eine textliche Darstellung eines Tages, drei Buchstaben Mon bis Sun
j Tag des Monats, ohne führenden Nullen 1 bis 31
l Eine volle textliche Darstellung einer Woche Sunday bis Saturday
N ISO-8601 numerische Darstellung des Wochentags 1 (für Monday) bis 7 (für Sunday)
S Englisches Ordnungssuffix für den Tag des Monats, 2 Zeichen st, nd, rd or th. Funktioniert gut mit  j
w Numerische Darstellung des Wochentags 0 (für Sunday) bis 6 (für Saturday)
z Der Tag des Jahres (beginnend bei 0) 0 bis 365

Für Wochen

Formelzeichen Beschreibung Beispiel Ergebnis
W ISO-8601 Wochennummer des Jahres, Die Woche beginnt montags 42 (die 42. Woche des Jahres)

Für Monate

Formelzeichen Beschreibung Beispiel Ergebnis
F Eine vollständige textuelle Darstellung eines Monats January bis December
m Numerische Darstellung eines Monats, mit führenden Nullen 01 bis 12
M Eine kurze textliche Darstellung eines Monats, drei Buchstaben Jan bis Dec
n Numerische Darstellung eines Monats, ohne führende Nullen 1 bis 12
t Anzahl der Tage im jeweiligen Monat 28 bis 31

Für Jahre

Formelzeichen Beschreibung Beispiel Ergebnis
L Ob es ein Schaltjahr ist 1 wenn Schaltjahr, 0 sonst
o ISO-8601-Jahreszahl. Diese hat denselben Wert wie Y, außer, wenn die ISO-Wochennummer (W) zum vorhergehenden oder nächsten Jahr gehört, dann wird dieses Jahr verwendet. 1999 oder 2003
Y Eine vollständige numerische Darstellung einer Jahreszahl, 4 Stellen 1999 oder 2003
y Eine zweistellige Darstellung einer Jahreszahl 99 oder 03

Für Zeit

Formelzeichen Beschreibung Beispiel Ergebnis
a Kleinbuchstaben Ante meridiem und Post meridiem am oder pm
A Großbuchstaben Ante meridiem und Post meridiem AM oder PM
B Swatch Internet Zeit 000 bis 999
g 12-Stunden-Format einer Stunde ohne führende Nullen 1 bis 12
G 24-Stunden-Format mit einer Stunde ohne führende Nullen 0 bis 23
h 12-Stunden-Format einer Stunde mit führende Nullen 01 bis 12
H 24-Stunden-Format mit einer Stunde mit führende Nullen 00 bis 23
i Minuten mit führenden Nullen 00 bis 59
s Sekunden mit führenden Nullen 00 bis 59

Für Zeitzonen

Formelzeichen Beschreibung Beispiel Ergebnis
e Kennung der Zeitzone UTC, GMT, Atlantic/Azores
l ob das Datum in der Sommerzeit liegt oder nicht 1 wenn Sommerzeit, 0 sonst
O Differenz zur Greenwich-Zeit (GMT) in Stunden 200
P Differenz zur Greenwich-Zeit (GMT) mit Doppelpunkt zwischen Stunden und Minuten +02:00
T Abkürzung der Zeitzone EST, MDT
Z Zeitzonenversatz in Sekunden. Der Versatz für Zeitzonen westlich von UTC ist immer negativ und für solche östlich von UTC ist immer positiv. -43200 through 50400

Für komplette Zeitstempel

Formelzeichen Beschreibung Beispiel Ergebnis
c ISO 8601 Datum 2004-02-12T15:19:21+00:00
r RFC 2822 formatiertes Datum Thu, 21 Dec 2000 16:01:07 +0200
U Sekunden seit der Unix-Epoche (1. Januar 1970 00:00:00 GMT)

Die folgenden Datumsfunktionen können mittels Calculated Fields verwendet werden:

date

Formel {date(format; timestamp)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
Beschreibung Erstellt ein Datum im gegebenen Format
Ergebnis Zeitstempel im gegebenen Format
Beispiel {date(ymd; 2016-02-11)} Ergebnis 160211

now

Formel {now(format)}
Parameter format: Formatzeichen
Beschreibung Erstellt das aktuelle Datum im gegebenen Format
Ergebnis Aktueller Zeitstempel im gegebenen Format
Beispiel {now(Y-m-d H:i:s)} Ergebnis 2016-04-29 15:08:03

yesterday

Formel {yesterday(format)}
Parameter format: Formatzeichen
Beschreibung Erstellt das gestrige Datum im gegebenen Format
Ergebnis Der gestrige Zeitstempel im gegebenen Format
Beispiel {yesterday(Y-m-d H:i:s)} Ergebnis 2016-04-28 15:08:03

tomorrow

Formel {tomorrow(format)}
Parameter format: Formatzeichen
Beschreibung Erstellt das morgige Datum im gegebenen Format
Ergebnis Der morgige Zeitstempel im gegebenen Format
Beispiel {tomorrow(Y-m-d H:i:s)} Ergebnis 2016-04-30 15:08:03

datediff

Formel {datediff(timestamp1; timestamp2; unit)}
Parameter timestamp1: Datum-/Zeitwert
timestamp2: Datum-/Zeitwert
unit: years/months/days/hours/minutes/seconds; default: days
Beschreibung Subtrahiert timestamp2 von timestamp1
Ergebnis Die Differenz zwischen beiden Zeitstempeln in der angegebenen unit
Beispiel {datediff(2016-02-01; 2016-04-22; days)} Ergebnis 81

addYears

Formel {addYears(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Fügt die unter amount hinterlegte Anzahl von Jahren zum Zeitstempel hinzu und gibt diesen im gegebenen Format aus.
Ergebnis Erhöhtes Datum in Format
Beispiel {addYears(Ymd; 2016-04-22; 1)} Ergebnis 20170422

addMonths

Formel {addMonths(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Fügt die unter amount hinterlegte Anzahl von Monaten zum Zeitstempel hinzu und gibt diesen im gegebenen Format aus.
Ergebnis Erhöhtes Datum in Format
Beispiel {addMonths(Ymd; 2016-04-22; 1)} Ergebnis 20160522

addDays

Formel {addDays(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Fügt die unter amount hinterlegte Anzahl von Tagen zum Zeitstempel hinzu und gibt diesen im gegebenen Format aus.
Ergebnis Erhöhtes Datum in Format
Beispiel {addDays(Ymd; 2016-04-22; 1)} Ergebnis 20160423

addHours

Formel {addHours(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Fügt die unter amount hinterlegte Anzahl von Stunden zum Zeitstempel hinzu und gibt diesen im gegebenen Format aus.
Ergebnis Erhöhtes Datum in Format
Beispiel {addHours(Ymd H:i:s; 2016-04-22 23:30; 5)} Ergebnis 20160423 04:30:00

addMinutes

Formel {addMinutes(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Fügt die unter amount hinterlegte Anzahl von Minuten zum Zeitstempel hinzu und gibt diesen im gegebenen Format aus.
Ergebnis Erhöhtes Datum in Format
Beispiel {addMinutes(Ymd H:i:s; 2016-04-22 22:58; 5)} Ergebnis 20160422 23:03:00

addSeconds

Formel {addSeconds(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Fügt die unter amount hinterlegte Anzahl von Sekunden zum Zeitstempel hinzu und gibt diesen im gegebenen Format aus.
Ergebnis Erhöhtes Datum in Format
Beispiel {addSeconds(Ymd H:i:s; 2016-04-22 22:58; 5)} Ergebnis 20160422 22:58:05

subtractYears

Formel {subtractYears(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Subtrahiert die unter amount hinterlegte Anzahl von Jahren vom Zeitstempel und gibt diesen im gegebenen Format aus.
Ergebnis Dezimiertes Datum in Format
Beispiel {subtractYears(Ymd; 2016-04-22; 5)} Ergebnis 20110422

subtractMonths

Formel {subtractMonths(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Subtrahiert die unter amount hinterlegte Anzahl von Monaten vom Zeitstempel und gibt diesen im gegebenen Format aus.
Ergebnis Dezimiertes Datum in Format
Beispiel {subtractMonths(Ymd; 2016-04-22; 5)} Ergebnis 20151122

subtractDays

Formel {subtractDays(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Subtrahiert die unter amount hinterlegte Anzahl von Tagen vom Zeitstempel und gibt diesen im gegebenen Format aus.
Ergebnis Dezimiertes Datum in Format
Beispiel {subtractDays(Ymd; 2016-04-22; 5)} Ergebnis 20160417

subtractHours

Formel {subtractHours(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Subtrahiert die unter amount hinterlegte Anzahl von Stunden vom Zeitstempel und gibt diesen im gegebenen Format aus.
Ergebnis Dezimiertes Datum in Format
Beispiel {subtractHours(Ymd H:i:s; 2016-04-22 12:37; 5)} Ergebnis 20160422 07:37:00

subtractMinutes

Formel {subtractMinutes(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Subtrahiert die unter amount hinterlegte Anzahl von Minuten vom Zeitstempel und gibt diesen im gegebenen Format aus.
Ergebnis Dezimiertes Datum in Format
Beispiel {subtractMinutes(Ymd H:i:s; 2016-04-22 12:37; 5)} Ergebnis 20160422 12:32:00

subtractSeconds

Formel {subtractSeconds(format; timestamp; amount)}
Parameter format: Formatzeichen
timestamp: Datum-/Zeitwert
amount: Ganzzahl
Beschreibung Subtrahiert die unter amount hinterlegte Anzahl von Sekunden vom Zeitstempel und gibt diesen im gegebenen Format aus.
Ergebnis Dezimiertes Datum in Format
Beispiel {subtractSeconds(Ymd H:i:s; 2016-04-22 12:37; 5)} Ergebnis 20160422 12:36:55

Kontroll-Funktionen

Es existiert eine Kontrollfunktion in Calculated Fields. Diese Funktion stellt sicher, dass sehr komplexe Formeln mit Bedingungen erstellt werden können. Da die Funktionen ineinander verschachtelt werden können, können Verzweigungen mit vielen Ästen erstellt werden.

ifThenElse

Formel {ifThenElse(condition; trueBranch; falseBranch)}
Parameter condition: Logikwert (bspw. die Auswertung einer logischen Funktion)
trueBranch: beliebiger Ausdruck
falseBranch: beliebiger Ausdruck
Beschreibung Wählt einen entsprechenden Ast, abhängig von der Bedingung
Ergebnis trueBranch, wenn die Bedingung korrekt ist, falseBranch, wenn die Bedingung falsch ist.
Beispiel {ifThenElse({equal(1; 1)}; 1 ist gleich 1; 1 ist ungleich 1)} Ergebnis 1 ist gleich 1

Counter Funktionen

Es gibt mehrere Zähler, die in Calculated Fields implementiert sind und in verschiedenen Szenarien verwendet werden können. Die Zähler sind in zwei Gruppen unterteilt:

  • Globale Zähler: Zähler, die jedes Mal erhöht werden, wenn eine betroffene Formel ausgewertet wird.
  • Tägliche Zähler: Zähler, die sich jeden Tag zurücksetzen (beginnen bei 1).

Weitere Erklärungen zu den unterschiedlichen Zählern findest du auch hier: Global Counter Manager

In den Beispielen nehmen wir an, dass der aktuelle Wert der Zähler 4 ist, sodass der erhöhte Wert mit dem gegebenen Format 5 sein wird.

GlobalCounter

Formel {GlobalCounter(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge
Ergebnis Zähler mit der Länge numberLength
Beispiel {GlobalCounter(meinName; 4)} Ergebnis 0005

GlobalCounterPerUser

Formel {GlobalCounterPerUser(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für den Benutzer, der einen Datensatz anlegt.
Ergebnis Zähler mit der Länge numberLength
Beispiel {GlobalCounterPerUser(meinName; 3)} Ergebnis 005

GlobalCounterPerModule

Formel {GlobalCounterPerModule(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für das Workflow Modul
Ergebnis Zähler mit Länge numberLength
Beispiel {GlobalCounterPerModule(meinName; 2)} Ergebnis 05

GlobalCounterPerUserPerModule

Formel {GlobalCounterPerUserPerModule(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für den Benutzer, der einen Datensatz im Workflow Modul anlegt.
Ergebnis Zähler mit der Länge numberLength
Beispiel {GlobalCounterPerUserPerModule(meinName; 1)} Ergebnis 5

DailyCounter

Formel {DailyCounter(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für jeden Tag.
Ergebnis Zähler mit der Länge numberLength, oder wenn der Zähler an diesem Tag nicht erhöht wird, dann 1 mit der Länge with length numberLength
Beispiel {DailyCounter(meinName; 1)} Ergebnis 5

DailyCounterPerUser

Formel {DailyCounterPerUser(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für jeden Tag für den Benutzer, der einen Datensatz anlegt.
Ergebnis Zähler mit der Länge numberLength, oder wenn der Zähler an diesem Tag nicht erhöht wird, dann 1 mit der Länge with length numberLength
Beispiel {GlobalCounterPerUser(meinName; 3)} Ergebnis 005

DailyCounterPerModule

Formel {DailyCounterPerModule(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für jeden Tag innerhalb des Workflow Moduls.
Ergebnis Zähler mit der Länge numberLength, oder wenn der Zähler an diesem Tag nicht erhöht wird, dann 1 mit der Länge with length numberLength
Beispiel {DailyCounterPerModule(meinName; 1)} Ergebnis 5

DailyCounterPerUserPerModule

Formel {DailyCounterPerUserPerModule(name; numberLength)}
Parameter name: beliebiger Text
numberLength: Ganzzahl
Beschreibung Zählt den Zähler mit dem gewählten Namen und der angegebenen Nummernlänge für einen Tag für den Benutzer, der einen Datensatz im Workflow Modul anlegt.
Ergebnis Zähler mit der Länge numberLength, oder wenn der Zähler an diesem Tag nicht erhöht wird, dann 1 mit der Länge with length numberLength
Beispiel {DailyCounterPerUserPerModule(meinName; 1)} Ergebnis 5

JSON-Funktionen

Mit den unterschiedlichen JSON Funktionen innerhalb der Calculated Fields kannst du JSON Arrays verarbeiten und so bspw. bestimmte Werte aus Arrays extrahieren oder Werte zu neuen JSON Arrays zusammensetzen.

CreateJSON

Formel {CreateJSON(parameter1;parameter2;parameter3;…)}
Parameter parameterX: Der Schlüssel und der Wert, die dem JSON-Objekt hinzugefügt werden sollen. Schlüssel und Wert werden durch einen Punkt . getrennt.
Beschreibung Erstellt ein JSON-Objekt aus den angegebenen Parametern.
Ergebnis Die Zeichenfolge des JSON-Objekts.
Beispiel {CreateJSON(abc.def;ghi.jkl)} – Erstellt ein JSON-Objekt {„abc“:“def“,“ghi“:“jkl“}

JsonExtract

Formel {JsonExtract(parameter1;parameter2;parameter3)}
Parameter parameter1: Die Zeichenfolge des JSON-Objekts
parameter2: Der abzurufende Schlüssel
parameter3: Der Standardwert, wenn der Schlüssel nicht existiert
Beschreibung Holt einen Wert aus einem JSON-Objekt nach Schlüssel.
Ergebnis Der Wert für den Schlüssel oder der Standardwert, wenn der Schlüssel nicht existiert.
Beispiel {JsonExtract({P0};abc;default)} – Holt den Wert für den Schlüssel abc aus dem JSON-Objekt im Parameter 0. Für {„abc“:“def“,“ghi“:“jkl“} würde def zurückgegeben werden.

JsonExplode

Formel {JsonExplode(parameter1;parameter2;parameter3)}
Parameter parameter1: Ein Zeichenfolgenwert, der durch parameter 2 getrennt ist
parameter2: Das Trennzeichen
parameter3: Standardwert. Vorsicht, dies gibt den Wert direkt zurück, nicht ein JSON-Array!
Beschreibung Zerlegt einen Zeichenfolgenwert in ein JSON-Array.
Ergebnis Die Zeichenfolge des JSON-Arrays.
Beispiel {JsonExplode(abc;,;ghi)} – Das Ergebnis ist [„abc“]

JsonImplode

Formel {JsonImplode(parameter1;parameter2;parameter3)}
Parameter parameter1: Ein JSON-Array-String
parameter2: Das Trennzeichen
parameter3: Standardwert. Wird nur verwendet, wenn das JSON ungültig ist!
Beschreibung Implodiert ein JSON-Array zu einem Zeichenkettenwert.
Ergebnis Der Zeichenkettenwert
Beispiel {JsonImplode({P0};,;)} – Implodiert das JSON-Array aus Parameter 0 zu einem Zeichenkettenwert. Für [„abc“,“def“,“ghi“] wäre das Ergebnis abc,def,ghi

replaceForJSON

Formel {replaceForJSON(parameter1)}
Parameter parameter1: Ein String, welcher konvertiert werden soll
Beschreibung Ersetzt <,> durch {,} – dies kann genutzt werden, da {,} in calculated Fields verwendet werden, aber man diese Zeichen braucht für JSON.
Ergebnis Der Zeichenkettenwert
Beispiel {replaceForJSON(<„test“:“1″>)} – Erzeugt ein JSON String {„test“:“1″}

PHP-Funktionen

Mit den PHP Funktionen können serialisierte PHP Arrays transformiert werden.

GetValueForKey

Formel {GetValueForKey(parameter1;parameter2)}
Parameter parameter1: Ein base64-kodiertes serialisiertes PHP-Array
parameter2: Der Schlüssel, der abgerufen werden soll. Verwende ., um auf verschachtelte Schlüssel zuzugreifen
Beschreibung Holt einen Wert aus einem serialisierten PHP-Array nach Schlüssel.
Ergebnis Der Wert für den Schlüssel oder null, wenn der Schlüssel nicht existiert.
Beispiel {GetValueForKey({P0};abc)} – Holt den Wert für den Schlüssel abc aus dem serialisierten PHP-Array im Parameter 0.

Marini Systems GmbH | Website | Datenschutz­erklärung | Impressum