Feldzuweisung mit Formel konfigurieren
Eine Regelanweisung vom Typ Feldzuweisung – Feldwert über Formel füllen berechnet den Zielwert dynamisch zur Laufzeit. Typische Einsatzfälle sind das Umrechnen von Währungsbeträgen, das Zusammensetzen von Texten aus mehreren Feldern oder das Übertragen eines technischen Schlüssels (z. B. GUID) in ein Selektionsfeld.
Voraussetzungen
- Sie haben mindestens eine Regel angelegt oder wollen eine neue Regel anlegen (siehe Regel anlegen).
- Sie kennen das Zielfeld, das befüllt werden soll (exportierbares Datenbankfeld der jeweiligen Datenbank).
- Der Formel-Editor ist Ihnen zugänglich (Benutzerrecht für Regelbearbeitung vorhanden).
- Die gewünschte Auswertungsposition ist festgelegt (z. B. Vor dem Speichern nach einer Neuanlage oder Änderung).
Einrichtung
Schritt 1: Regelanweisung öffnen oder neu anlegen
Navigieren Sie zur Regelverwaltung:
PARAMETER - (JEWEILIGEN BEREICH WÄHLEN) - REGELN
Öffnen Sie die gewünschte Regel per Doppelklick oder legen Sie eine neue Regel an. Wechseln Sie im Regelformular in den Reiter Regelanweisungen.
Klicken Sie auf Neu, um eine neue Regelanweisung anzulegen.
Ergebnis: Das Formular für eine einzelne Regelanweisung ist geöffnet.
Schritt 2: Anweisungsart „Feldwert über Formel füllen" wählen
Wählen Sie im Feld Anweisungsart den Eintrag Feldzuweisung.
Darunter erscheint das Unterfeld Art der Feldzuweisung. Wählen Sie dort:
Feldwert über Formel füllen
ℹ️ Abgrenzung zu anderen Feldzuweisungsarten - Feldwert mit Vorgabewert füllen — trägt einen festen, einmalig eingetragenen Text oder Zahlenwert ein. - Feldwert über Formel füllen — berechnet den Wert dynamisch anhand von Datenbankfeldern und Funktionen. - Feldwert löschen — entfernt den bisherigen Inhalt des Zielfelds ohne Ersatz.
Ergebnis: Das Formular zeigt zusätzlich das Feld Zielfeld und die Schaltfläche zum Öffnen des Formel-Editors.
Schritt 3: Zielfeld auswählen
Klicken Sie auf die Auswahlhilfe neben dem Feld Feld (Zielfeld).
Es öffnet sich eine Liste aller exportierbaren Datenbankfelder der Datenbank, die zur gewählten Auswertungsposition gehört. Wählen Sie das Feld, das mit dem Formelwert befüllt werden soll.
⚠️ Feldtyp beachten Der Rückgabetyp der Formel muss zum Datentyp des Zielfelds passen. Eine Formel, die einen Text zurückgibt, kann nicht in ein reines Zahlenfeld geschrieben werden. Selektionsfelder (Typ Char) eignen sich für nahezu alle Formelrückgaben.
⚠️ Blob-Felder nicht verwenden Variabel lange Felder (Blob-Felder) können als Zielfeld zu Laufzeitfehlern führen. Die Analyse-Funktion weist auf diesen Konflikt hin. Wählen Sie stattdessen ein normales Textfeld oder ein Selektionsfeld.
Ergebnis: Das Zielfeld ist eingetragen.
Schritt 4: Formel im Formel-Editor erstellen
Klicken Sie auf die Schaltfläche Formel bearbeiten (Stift- oder Auslassungssymbol neben dem Formelfeld).
Der Formel-Editor bietet folgende Bereiche:
| Bereich | Funktion |
|---|---|
| Feldliste | Alle exportierbaren Felder der aktuellen Datenbank – per Doppelklick in die Formel einfügen |
| Funktionsliste | Verfügbare Formelfunktionen (z. B. $BPVar, arithmetische und String-Funktionen) |
| Formelbereich | Eingabe und Bearbeitung der Formel |
| Vorschau / Test | Zeigt das Ergebnis mit einem Beispieldatensatz |
Bauen Sie die Formel auf. Typische Muster:
Feldwert aus anderem Feld übertragen
[DB_FELDNAME]
Betrag in Fremdwährung umrechnen
[BETRAG] * [WECHSELKURS]
GUID über $BPVar eintragen
$BPVar('GUID')
Text aus mehreren Feldern zusammensetzen
[VORNAME] + ' ' + [NACHNAME]
Bestätigen Sie die Formel mit OK oder Übernehmen.
Ergebnis: Die fertige Formel ist im Formelfeld der Regelanweisung eingetragen.
Schritt 5: Steueroptionen der Anweisung prüfen
Prüfen Sie im Regelanweisungsformular die folgenden Steuerfelder und setzen Sie sie nach Bedarf:
| Feld | Wirkung |
|---|---|
| Keine weiteren Regelanweisungen auswerten | Stoppt die Auswertung weiterer Anweisungen innerhalb dieser Regel, sobald die vorliegende Anweisung ausgeführt wurde. |
| Keine weiteren Regeln auswerten | Stoppt die Auswertung aller nachfolgenden Regeln an dieser Auswertungsposition. |
| Nur ausführen, wenn zuvor keine Regelanweisung ausgeführt wurde | Die Anweisung greift nur dann, wenn keine vorherige Anweisung in dieser Regelauswertung bereits ausgeführt wurde – sinnvoll als Fallback. |
ℹ️ Verzweigte Bedingungen Wenn die Regelanweisung nur unter einer zusätzlichen Bedingung ausgeführt werden soll, nutzen Sie das Feld Vergleichswert für verzweigte Bedingung. Damit können Sie innerhalb einer Regel unterschiedliche Formeln je nach Datenkonstellation ausführen, ohne mehrere separate Regeln anlegen zu müssen.
Ergebnis: Die Steueroptionen sind konfiguriert.
Schritt 6: Regelanweisung und Regel speichern
Speichern Sie die Regelanweisung mit OK oder Speichern.
Speichern Sie anschließend die übergeordnete Regel.
⚠️ Buchungsparameter prüfen Wenn die Auswertungsposition Beim Buchen / Stornieren von Vorgängen oder eine verwandte Buchungsposition ist, muss im zugehörigen Buchungsparameter das Kennzeichen Adress-/Artikel-/Projekt-Regeln für Buchen/Stornieren abarbeiten aktiviert sein. Andernfalls wird die Regel zur Laufzeit nicht ausgeführt. Weitere Details: Buchungsparameter-Kopplung.
Ergebnis: Die Regelanweisung vom Typ „Feldwert über Formel füllen" ist gespeichert und aktiv.
Ergebnis
Die Regel berechnet den Zielwert ab sofort bei jeder Auswertung automatisch über die hinterlegte Formel und schreibt das Ergebnis in das konfigurierte Zielfeld. Manuelle Eingriffe in das Feld sind nicht mehr notwendig.