Zum Hauptinhalt springen

Globale Berechnungen

Globale Berechnungen sind Formeln, die du einmal zentral anlegst und die anschließend in allen Konfigurationen als Variable global.calculations.key zur Verfügung stehen — in Preis-, Gewichts-, Lagerbestands- und Lieferzeitberechnungen genauso wie in Validierungen und Sichtbarkeitsformeln.

Wozu globale Berechnungen?​

  • Einmal pflegen, überall nutzen: Werte wie ein Material-Grundpreis, ein Zuschnittkosten-Faktor oder eine Marge werden zentral gepflegt. Ändert sich der Wert, wirkt die Änderung sofort in allen Konfigurationen — ohne eine einzige Formel anzufassen.
  • Wiederverwenden statt kopieren: Wiederkehrende Ausdrücke (z.B. die Umrechnung einer Längeneingabe in Meter) stehen als benannte Variable bereit, statt in mehrere Formeln kopiert zu werden.
  • Lesbarkeit: global.calculations.schnittkosten ist in einer Formel deutlich verständlicher als der ausgeschriebene Ausdruck.
hinweis

Der Unterschied zu Zwischenberechnungen: Zwischenberechnungen gehören zu einer Konfiguration, globale Berechnungen gelten für alle Konfigurationen.

Anlegen​

Du findest die globalen Berechnungen unter Kataloge > neonlines Konfigurator im Tab Globale Berechnungen:

  1. Klicke auf Globale Berechnung hinzufügen.
  2. Vergib einen Namen (Anzeige im Admin) und einen Key — unter diesem Key sprichst du die Berechnung später in Formeln an.
  3. Lege die Position fest — sie bestimmt die Reihenfolge, in der die globalen Berechnungen ausgewertet werden.
  4. Hinterlege die Formel (einfacher Modus oder Profimodus). Es stehen die üblichen Variablen zur Verfügung, z.B. Feldwerte (fields.…), Produktvariablen und selectedQuantity.
  5. Optional: Lege einen Fallback fest — schlägt die Auswertung fehl oder passt der Ergebnistyp nicht, wird stattdessen der Fallback-Wert verwendet (mit Hinweis im Debug-Log).

Verwendung in Formeln​

Das Ergebnis rufst du über den Key ab — im einfachen Modus:

selectedQuantity * global.calculations.schnittkosten

Im Profimodus:

{"*": [{"var": "selectedQuantity"}, {"var": "global.calculations.schnittkosten"}]}

API-Modus​

Neben dem einfachen Modus und dem Profimodus können globale Berechnungen (und Zwischenberechnungen) ihr Ergebnis auch von einer externen API beziehen — z.B. von einem Preisrechner deiner Warenwirtschaft:

  1. Aktiviere im Formeleditor den Schalter „API-Modus aktivieren".
  2. Wähle die API Methode (GET oder POST) und trage die API URL ein.
  3. Lege fest, welche Konfigurator-Variablen bei jedem Abruf übergeben werden (kommagetrennt, z.B. selectedQuantity, fields.laenge.value).

Die Antwort der API wird als Berechnungsergebnis verwendet.

hinweis

Der Abruf erfolgt live während der Konfiguration — die API sollte also schnell und zuverlässig antworten. Lege für den Fehlerfall einen Fallback-Wert fest.

Auswertung & Regeln​

  • Globale Berechnungen werden pro Produkt und Konfiguration live ausgewertet — sie können also Feldwerte und Produktvariablen des jeweiligen Produkts nutzen und ändern sich mit den Kundeneingaben.
  • Sie werden vor den Zwischenberechnungen ausgewertet: Zwischenberechnungen dürfen globale Ergebnisse verwenden — umgekehrt kann eine globale Berechnung keine andere globale Berechnung und keine Zwischenberechnung referenzieren.
  • Referenziert eine globale Berechnung ein Feld (z.B. fields.laenge.value), muss ein Feld mit diesem Key in der jeweiligen Konfiguration existieren — sonst greift der Fallback.

Beispiel: Meterware​

Eine globale Berechnung mit dem Key mass_length liefert die eingegebene Länge in Millimetern:

{ "var": "fields.laenge.value" }

Damit lässt sich in jeder Konfiguration mit einem laenge-Feld der Materialverbrauch berechnen — z.B. in der Lagerbestandsberechnung:

{
  "*": [
    { "var": "selectedQuantity" },
    { "/": [ { "var": "global.calculations.mass_length" }, 1000 ] }
  ]
}

Ergebnis: Verbrauch in Metern (Anzahl × Länge in mm ÷ 1000).

Live-Demo: Stoff mit Meter als Lagerbestand

Auf dieser Seite