Berechnungsregeln Übersicht ANTEROS besitzt im Bereich Admin ein Menü namens "Berechnungsregeln". Über diesen Aspekt ist es möglich, Berechnungen mit eingepflegten Parameter durchzuführen. Das heißt folglich, dass man mit einer Regel, einen Parameterwert berechnen kann. Die Werte, die für die Berechnung verwendet werden, sind eingepflegte Parameterwerte, auf die mittels Platzhaltern zugegriffen wird. Das Ergebnis dieser Berechnung wird in einem Zielparameter geschrieben. Die Berechnungsregeln sind vielfältig einsetzbar. Sie können mit einer Berechnungsregel Werte berechnen, die sich aus unterschiedlichen Parameterwerten zusammen setzen. Dies kann beispielsweise nützlich sein, um Rabatte je Kunde zu berechnen oder für die Umrechnung von Währungen. Wie die Berechnungen genau funktionieren wird im folgenden Kurzfilm erläutert und anschließend durch Beispiele vorgeführt.
Sobald Sie auf das Menü "Berechnungsregeln" klicken, gelangen Sie in die folgende Ansicht:
In der Liste auf der linken Seite sehen Sie alle bereits angelegten Regeln. Um eine von diesen in den Editor zu laden, müssen Sie nur auf die entsprechende Zeile in der Liste klicken. Mit Hilfe der "Aktionen"-Spalte können Sie außerdem eine Regel duplizieren, löschen oder eine neue Berechnungsregel anlegen. Ebenso finden Sie ein Lösch- und ein Neu-Symbol in der Leiste oberhalb des Editors. Wenn Sie auf das Neu-Symbol klicken und somit die Erstellung einer neuen Berechnungsregel starten, öffnet sich ein Dialogfenster, in dem ein automatisch generierter Code für die Regel angezeigt wird. Diesen können Sie nach Ihrer Vorstellung anpassen oder den Standard-Code beibehalten. Nachdem Sie auf den "Erstellen"-Button geklickt haben, öffnet sich ein leerer Editor, in dem Sie nun Angaben zu Ihrer neuen Berechnungsregel hinterlegen können.
Eine Berechnungsregel können Sie an Parameterdefinitionen oder direkt an einen Parameter hinterlegen. Falls eine Berechnungsregel an einer Parameterdefinition hinterlegt ist, dann kann diese am Parameter durch eine andere Berechnungsregel ersetzt werden. Das kann für Parameter einer Kategorie, eines Produkttyps oder eines strukturierten Typs gemacht werden.
Reiter Allgemein Im Reiter "Allgemein" können Sie für die Berechnugsregel einen Namen und eine Beschreibung angeben und außerdem nach Belieben den Code nochmal überarbeiten. Zu Empfehlen ist hier ein Code, der sprechend für die Berechnungsregel ist.
Reiter Berechnungsregel Im Reiter "Berechnungsregeln" müssen Sie nun mehrere Entscheidungen für Ihre Berechnungsregel treffen, bevor Sie die eigentliche Schablone für die Regel erstellen. Parameterwerte-Typ: Hier legen Sie den Typ des zu berechnenden Parameter fest. Zur Auswahl stehen dabei "Kein Wert", "Text (sprachneutral)", "Text (übersetzbare)", "Zahl" und "Zahlenbereich" Datentypen: Für den Datentyp können Sie aus der Auflistung "Produkt", "Imageseite", "Produktreihe", "Unternehmen" und "Webseite" auswählen und hierbei können Sie auch mehrere Datentypen selektieren. Daten ID: Hier wählen Sie die relevanten Feldern für Ihre Berechnungsregel aus und Sie können diesen einen Namen geben, unter dem Sie die Felder in der Regel referenzieren können. In dem Feld "Schablone" können Sie nun auf die zuvor festgelegten Felder zugreifen und so die eigentliche Berechnungsregel eintragen. Die Berechnungsregeln werden mit FTL (FreeMarker Template Language) gestaltet. Auf dieser Website https://freemarker.apache.org/docs/dgui_quickstart_template.html können Sie sich genauer über diese Sprache informieren. Im Folgenden werden einige Beispiele aufgelistet, um Ihnen die Funktionsweise näher zubringen. Ausgabe des Feldes mit dem Namen "length": ${length} Ausgabe des Feldes mit dem Namen "length" mit einem Default-Wert, wenn kein anderer vorhanden ist: ${length!} Flächenberechnung mit den Felder "length" und "width": ${length * width} Ausgabe, wenn Feld "length" gesetzt ist: [#if length??]Länge gesetzt[/#if] Ausgabe abhängig davon, ob Feld "length" gesetzt ist: [#if length??]Länge gesetzt[#else]Länge nicht gesetzt[/#if] für eine weitere verschachtelte if-Anweisung gibt es auch noch [#elseif] Ausgabe von Mehrfachwerten von einem Parameter mit Namen "values": Ausgabe des ersten Wertes: ${values} Ausgabe aller Werte mit "/" getrennt: ${values?join(" / ")} Ausgabe aller Werte in eienr Liste: siehe https://freemarker.apache.org/docs/ref_directive_list.html Am unteren Ende des Reiters finden Sie eine Vorschau-Funktion, mit der man Daten-Objekte gemäß der hinterlegten Datentypen auswählen kann, um das Ergebnis zu sehen oder auch Fehler zu erhalten, wenn das Template fehlerhaft ist. Im Parameterdefinitionseditor kann man folgend eine definierte Berechnungsregeln gemäß des Werte-Typs auswählen. Das geht nicht, wenn es Vorgabewerte gibt.
Unterhalb der Schablone steht eine Vorschaufunktion zur Verfügung. Hier kann man ein Daten-Objekt der oben eingestellten Datentypen wählen. Das Ergebnis der Berechnung wird darunter ausgegeben. Falls die Schablone fehlerhaft ist, wird dies rechts von dem „Refresh“-Button angezeigt. Wenn man z.B. auf eine Variable zugreift, ohne zu prüfen, ob diese mit einem Wert belegt ist (z.B. mit „!“: ${length!} oder per [#if ...??]):
Reiter Änderungen In diesem Reiter können Sie genau sehen, wer wann welche Änderungen an diesem Objekt durchgeführt hat. Details zur Aktion kann man per Klick auf das Pfeil-Symbol links erhalten. So wird beispielsweise im Screenshot unten nach Klick auf das Symbol angezeigt, dass der Parameter L von 100 auf 102 geändert wurde.
Damit Sie bei den vielen Punkten gezielte Änderungen herausfinden können, stehen Ihnen verschiedene Filtermöglichkeiten zur Verfügung. Datum: Hier können Sie den Zeitraum der Änderungen einschränken. Bearbeiter: Hier können Sie festlegen, ob nur Änderungen angezeigt werden sollen, die von Ihnen durchgeführt wurden. Art der Änderung: Hier können Sie entscheiden, ob alle Änderungen angezeigt werden sollen oder nur Aktionen bei denen Daten entweder erstellt, geändert oder gelöscht wurden.

Berechnungsregeln

Übersicht

ANTEROS besitzt im Bereich Admin ein Menü namens "Berechnungsregeln". Über diesen Aspekt ist es möglich, Berechnungen mit eingepflegten Parameter durchzuführen. Das heißt folglich, dass man mit einer Regel, einen Parameterwert berechnen kann. Die Werte, die für die Berechnung verwendet werden, sind eingepflegte Parameterwerte, auf die mittels Platzhaltern zugegriffen wird. Das Ergebnis dieser Berechnung wird in einem Zielparameter geschrieben.
Die Berechnungsregeln sind vielfältig einsetzbar. Sie können mit einer Berechnungsregel Werte berechnen, die sich aus unterschiedlichen Parameterwerten zusammen setzen. Dies kann beispielsweise nützlich sein, um Rabatte je Kunde zu berechnen oder für die Umrechnung von Währungen.

Wie die Berechnungen genau funktionieren wird im folgenden Kurzfilm erläutert und anschließend durch Beispiele vorgeführt.

Sobald Sie auf das Menü "Berechnungsregeln" klicken, gelangen Sie in die folgende Ansicht:

In der Liste auf der linken Seite sehen Sie alle bereits angelegten Regeln. Um eine von diesen in den Editor zu laden, müssen Sie nur auf die entsprechende Zeile in der Liste klicken. Mit Hilfe der "Aktionen"-Spalte können Sie außerdem eine Regel duplizieren, löschen oder eine neue Berechnungsregel anlegen. Ebenso finden Sie ein Lösch- und ein Neu-Symbol in der Leiste oberhalb des Editors.
Wenn Sie auf das Neu-Symbol klicken und somit die Erstellung einer neuen Berechnungsregel starten, öffnet sich ein Dialogfenster, in dem ein automatisch generierter Code für die Regel angezeigt wird. Diesen können Sie nach Ihrer Vorstellung anpassen oder den Standard-Code beibehalten. Nachdem Sie auf den "Erstellen"-Button geklickt haben, öffnet sich ein leerer Editor, in dem Sie nun Angaben zu Ihrer neuen Berechnungsregel hinterlegen können.

Eine Berechnungsregel können Sie an Parameterdefinitionen oder direkt an einen Parameter hinterlegen. Falls eine Berechnungsregel an einer Parameterdefinition hinterlegt ist, dann kann diese am Parameter durch eine andere Berechnungsregel ersetzt werden. Das kann für Parameter einer Kategorie, eines Produkttyps oder eines strukturierten Typs gemacht werden.

Reiter Allgemein

Im Reiter "Allgemein" können Sie für die Berechnugsregel einen Namen und eine Beschreibung angeben und außerdem nach Belieben den Code nochmal überarbeiten. Zu Empfehlen ist hier ein Code, der sprechend für die Berechnungsregel ist.

Reiter Berechnungsregel

Im Reiter "Berechnungsregeln" müssen Sie nun mehrere Entscheidungen für Ihre Berechnungsregel treffen, bevor Sie die eigentliche Schablone für die Regel erstellen.

Parameterwerte-Typ: Hier legen Sie den Typ des zu berechnenden Parameter fest. Zur Auswahl stehen dabei "Kein Wert", "Text (sprachneutral)", "Text (übersetzbare)", "Zahl" und "Zahlenbereich"
Datentypen: Für den Datentyp können Sie aus der Auflistung "Produkt", "Imageseite", "Produktreihe", "Unternehmen" und "Webseite" auswählen und hierbei können Sie auch mehrere Datentypen selektieren.
Daten ID: Hier wählen Sie die relevanten Feldern für Ihre Berechnungsregel aus und Sie können diesen einen Namen geben, unter dem Sie die Felder in der Regel referenzieren können.

In dem Feld "Schablone" können Sie nun auf die zuvor festgelegten Felder zugreifen und so die eigentliche Berechnungsregel eintragen. Die Berechnungsregeln werden mit FTL (FreeMarker Template Language) gestaltet. Auf dieser Website https://freemarker.apache.org/docs/dgui_quickstart_template.html können Sie sich genauer über diese Sprache informieren.

Im Folgenden werden einige Beispiele aufgelistet, um Ihnen die Funktionsweise näher zubringen.

Ausgabe des Feldes mit dem Namen "length": ${length}
Ausgabe des Feldes mit dem Namen "length" mit einem Default-Wert, wenn kein anderer vorhanden ist: ${length!}
Flächenberechnung mit den Felder "length" und "width": ${length * width}
Ausgabe, wenn Feld "length" gesetzt ist: [#if length??]Länge gesetzt[/#if]
Ausgabe abhängig davon, ob Feld "length" gesetzt ist: [#if length??]Länge gesetzt[#else]Länge nicht gesetzt[/#if]
- für eine weitere verschachtelte if-Anweisung gibt es auch noch [#elseif]
Ausgabe von Mehrfachwerten von einem Parameter mit Namen "values":
- Ausgabe des ersten Wertes: ${values}
- Ausgabe aller Werte mit "/" getrennt: ${values?join(" / ")}
- Ausgabe aller Werte in eienr Liste: siehe https://freemarker.apache.org/docs/ref_directive_list.html

Am unteren Ende des Reiters finden Sie eine Vorschau-Funktion, mit der man Daten-Objekte gemäß der hinterlegten Datentypen auswählen kann, um das Ergebnis zu sehen oder auch Fehler zu erhalten, wenn das Template fehlerhaft ist.

Im Parameterdefinitionseditor kann man folgend eine definierte Berechnungsregeln gemäß des Werte-Typs auswählen. Das geht nicht, wenn es Vorgabewerte gibt.

Unterhalb der Schablone steht eine Vorschaufunktion zur Verfügung. Hier kann man ein Daten-Objekt der oben eingestellten Datentypen wählen. Das Ergebnis der Berechnung wird darunter ausgegeben. Falls die Schablone fehlerhaft ist, wird dies rechts von dem „Refresh“-Button angezeigt. Wenn man z.B. auf eine Variable zugreift, ohne zu prüfen, ob diese mit einem Wert belegt ist (z.B. mit „!“: ${length!} oder per [#if ...??]):

Reiter Änderungen

In diesem Reiter können Sie genau sehen, wer wann welche Änderungen an diesem Objekt durchgeführt hat. Details zur Aktion kann man per Klick auf das Pfeil-Symbol links erhalten. So wird beispielsweise im Screenshot unten nach Klick auf das Symbol angezeigt, dass der Parameter L von 100 auf 102 geändert wurde.

Damit Sie bei den vielen Punkten gezielte Änderungen herausfinden können, stehen Ihnen verschiedene Filtermöglichkeiten zur Verfügung.

Datum: Hier können Sie den Zeitraum der Änderungen einschränken.

Bearbeiter: Hier können Sie festlegen, ob nur Änderungen angezeigt werden sollen, die von Ihnen durchgeführt wurden.

Art der Änderung: Hier können Sie entscheiden, ob alle Änderungen angezeigt werden sollen oder nur Aktionen bei denen Daten entweder erstellt, geändert oder gelöscht wurden.