Anweisungsart: Feldzuweisung
Die Anweisungsart Feldzuweisung ist die häufigste Regelanweisung im microtech-Regelsystem. Sie schreibt einen Wert in ein Datenbankfeld – entweder als festen Vorgabewert, als berechnete Formel oder durch gezieltes Löschen des Feldinhalts. Diese Seite beschreibt alle Varianten und die zugehörigen Konfigurationsfelder.
Wo konfiguriere ich das in der Software?
PARAMETER - (Auswahl des Regel-Bereichs) - REGELN - NEU / ÄNDERN - Bereich: Anweisungen (Dann) - Schaltfläche: NEU - Auswahlfeld: Anweisungsart
Wählen Sie z. B. als Auswertungsposition "Vor dem Speichern nach einer Neuanlage oder Änderung (…)" und als neuen Regelanweisungs-Datensatz "Feldzuweisungen". Über die Zuweisungen wählen Sie per Dropdown-Menü das Feld, das eine Zuweisung erhalten soll, und die "Art der Feldzuweisung".
Grundprinzip
Eine Feldzuweisungs-Anweisung besteht aus drei Pflichtangaben:
| Angabe | Beschreibung |
|---|---|
| Feld | Das Datenbankfeld, in das der Wert geschrieben wird (aus dem Feldexport der jeweiligen Datenbank per Dropdown wählbar). |
| Art der Feldzuweisung | Legt fest, wie der Wert ermittelt wird: Vorgabewert, Formel oder Löschen. |
| Vorgabewert / Formel | Der konkrete Wert oder Formelausdruck, der dem Feld zugewiesen wird (entfällt bei "Feldwert löschen"). |
Beachten Sie
Nur exportierbare Felder:
Als Zielfeld können ausschließlich Felder ausgewählt werden, die auch im Feldexport der jeweiligen Datenbank zur Verfügung stehen. Intern berechnete oder systemgeschützte Felder sind nicht wählbar.
Art der Feldzuweisung
Feldwert mit Vorgabewert füllen
Der Inhalt des Zielfelds wird mit einem fest eingetragenen Wert überschrieben. Der Wert wird im Feld Vorgabewert eingetragen.
| Feld | Verhalten |
|---|---|
| Vorgabewert | Freitextfeld; der eingegebene Wert wird unverändert in das Zielfeld geschrieben. |
| Formel | Nicht aktiv – das Formelfeld bleibt leer. |
| Typische Anwendung | Kennzeichen setzen, feste Texte oder Codes eintragen, numerische Konstanten schreiben. |
Beispiel: In einem Selektionsfeld soll immer der Text GESPERRT eingetragen werden, wenn eine bestimmte Bedingung zutrifft.
Feldwert über Formel füllen
Der Inhalt des Zielfelds wird über einen Formelausdruck ermittelt. Die Formel wird im Formeleditor erfasst.
| Feld | Verhalten |
|---|---|
| Formel | Formelausdruck gemäß microtech-Formelsyntax; Zugriff auf Felder der Datenbank, Systemvariablen und Funktionen möglich. |
| Vorgabewert | Nicht aktiv – der Vorgabewert bleibt leer. |
| Typische Anwendung | Berechnungen, Verkettungen, Währungsumrechnungen, GUID-Generierung, Datumswerte. |
Beispiel: In diesem Beispiel wird geprüft, ob im Feld "Branche" der Wert "Gastronomie" gesetzt ist. Wenn ja, dann wird in Selektionsfeld 5 "Essen" geschrieben, ansonsten "Lieferdienst".
if(«Adr.Branche»='Gastronomie','Essen','Lieferdienst')
Häufig verwendete Formelelemente
| Element | Bedeutung |
|---|---|
[FELDNAME] | Wert eines Datenbankfelds der aktuellen Tabelle |
$BPVar("...") | Wert einer Buchungsparameter-Variable (z. B. GUID) |
$Str(...) | Konvertierung Zahl → Text |
$Val(...) | Konvertierung Text → Zahl |
$Date(...) | Datumsfunktionen |
+ - * / | Arithmetische Verknüpfung numerischer Felder |
+ (Texte) | Verkettung von Zeichenketten |
Beachten Sie
Blob-Felder (z. B. Bilder) nicht als Formelquelle verwenden: Die Analyse-Funktion warnt, wenn eine Formel auf variabel lange Felder (Blob-Felder, z. B. Bilder) zugreift, da dies bei bestimmten Auswertungspositionen nicht unterstützt wird und zu Fehlern führen kann.
Beachten Sie
DBInfo-Funktion in Formeln: Wenn die Formel die Funktion DBInfo verwendet, prüft die Analyse-Funktion, ob die gewählte Auswertungsposition dies unterstützt. Bei nicht unterstützten Positionen wird eine Warnung ausgegeben.
Feldwert löschen
Der Inhalt des Zielfelds wird geleert. Vorgabewert und Formel bleiben ohne Eingabe.
| Feld | Verhalten |
|---|---|
| Vorgabewert | Kein Eintrag erforderlich. |
| Formel | Kein Eintrag erforderlich. |
| Typische Anwendung | Rücksetzen eines Felds auf leer, z. B. beim Stornieren oder bei einer Statusrücksetzung. |
Beispiel: Über eine solche Zuweisung kann z. B., wenn die Bedingung im Regel-Datensatz zutrifft, dass der Status "Kunde" ist, "Textfeld 2" gelöscht werden, da in diesem Lieferanteninformationen gespeichert sind. Im Bereich der Anweisung kann nun über "Zuweisungen" der Feldwert des nicht benötigten Feldes gelöscht werden.
Die Bedingung prüft folgende Konstellation:
«Adr.Status»='Kunde'
Die Zuweisung führt beim Zutreffen der Bedingung das Löschen des Feldwerts aus:
Beachten Sie
Löschen vs. Vorgabewert leer: "Feldwert löschen" und "Vorgabewert mit leerem Inhalt füllen" verhalten sich bei Textfeldern ähnlich, können sich bei Zahlenfeldern oder Datumsfeldern jedoch unterschiedlich auswirken. Verwenden Sie für ein echtes Nullsetzen von Datumsfeldern gezielt die Variante "Feldwert löschen".
Steueroptionen auf Anweisungsebene
Jede Regelanweisung – unabhängig von der Art der Feldzuweisung – verfügt über folgende Steuerfelder:
Nach Ausführen dieser Anweisung, keine weiteren Regelanweisungen auswerten
| Status | Wirkung |
|---|---|
| Inaktiv (Standard) | Nach Ausführung dieser Anweisung werden weitere Anweisungen innerhalb der gleichen Regel normal ausgewertet. |
| Aktiv | Nach Ausführung dieser Anweisung werden keine weiteren Anweisungen innerhalb der aktuellen Regel ausgewertet. |
Sonst-Logik ohne Gegenbedingung
Über dieses Kennzeichen lässt sich eine "Sonst"-Logik abbilden, ohne die Gegenbedingung explizit formulieren zu müssen: Wird das Kennzeichen bei einer früheren Anweisung aktiviert, kommt eine nachfolgende Anweisung nur dann zur Ausführung, wenn die vorherige nicht gelaufen ist – also praktisch "sonst mache X". Die Steuerung erfolgt damit an der vorangehenden, nicht an der nachfolgenden Anweisung.
Nach Ausführen dieser Anweisung, keine weiteren Regeln auswerten
| Status | Wirkung |
|---|---|
| Inaktiv (Standard) | Nach Ausführung dieser Anweisung werden weitere Regeln an der gleichen Auswertungsposition normal geprüft. |
| Aktiv | Nach Ausführung dieser Anweisung werden keine weiteren Regeln an dieser Auswertungsposition ausgewertet. Alle nachfolgenden Regeln werden übersprungen. |
Beachten Sie
Reihenfolge beachten: Das Kennzeichen "Keine weiteren Regeln auswerten" wirkt sich auf alle nachfolgend sortierten Regeln an dieser Auswertungsposition aus. Prüfen Sie vor der Aktivierung die Reihenfolge Ihrer Regeln sorgfältig. Über die blauen Pfeile im Menüband lässt sich die Reihenfolge einstellen.
Kompatibilität mit Auswertungspositionen
Die Anweisungsart Feldzuweisung steht an nahezu allen Auswertungspositionen zur Verfügung. Einschränkungen gelten bei positions- oder vorgangsbezogenen Spezialauswertungen:
| Auswertungsposition | Feldzuweisung verfügbar |
|---|---|
| Vor dem Speichern (Erfassungsformular) | ✓ |
| Vor dem Buchen von Vorgängen | ✓ |
| Nach dem Buchen / Stornieren von Vorgängen | ✓ |
| Beim Buchen / Stornieren (Adressen, Artikel, Projekte) | ✓ |
| Beim Buchen / Stornieren von Positionen | ✓ |
| Vor / Nach dem Wandeln | ✓ |
| Vor / Nach dem Übernehmen von Vorgangspositionen | ✓ |
| Farbdarstellung | ✗ (eigene Anweisungsart) |
| QuickInfo | ✗ (eigene Anweisungsart) |
Verfügbarkeit je Anweisungsart
Eine vollständige Übersicht, welche Anweisungsarten an welcher Auswertungsposition zur Verfügung stehen, finden Sie in der → Auswertungspositionen – Referenz