Zweck: Die Einfache Feld-Einschränkung definiert ein Suchkriterium, das einer geeigneten Projektion einen statischen Vergleichswert oder $null gegenüberstellt.

Sofern sich die Projektion sich auf ein geeignetes Feld bezieht, kann überprüft werden, ob dieses mit einem beliebigen Wert gefüllt ist (!=$null) oder leer (==$null).

Für den Vergleich darf keinem der Vergleichwert-Parameter (Zeichenfolge, Long-Wert, Int-Wert, Boolean-Wert) ein Wert zugeordnet sein.
►HINWEIS◄ Der Screenshot oben zeigt den Neutralzustand (==$null) der Checkbox für den Boolean-Wert, der hier ausdrücklich von $false unterschieden wird.

Grundsätzlich sind Felder aller simplen Datentypen geeignet für eine Prüfung auf "gefüllt" oder "leer", soweit der als Projektion angegebene Pfad datenbankseitig interpretiert werden kann.

Für Felder mit komplexem Datentyp, die nicht komplette Entitäten referenzieren - hierzu zählt bereits ein "Datum/Uhrzeit" (DateTime) mit den Feldern "Datumswert" (dateValue) und "Zeitzone" (timeZone) - wird die Prüfung gegen $null datenbankseitig je Feld ausgeführt.

Verknüpfte Entität-Felder werden datenbankseitig auch dann nur als Long-Referenz auf die "ID" der Entitätsinstanz persistiert, wenn die Option "Nur referenzieren" abgewählt ist. Eine Prüfung ohne Vergleichswert bezieht sich damit auf ein simples Long-Feld.

In Bezug auf plurale Inhalte sind folgende Fälle zu unterscheiden:

• Bezieht sich ein "Listenfeld" auf eine Wiederholbare Entität, z. B. auch das Feld "Positionen" (lineItems) für ein Hierarchisches Geschäftobjekt, sollte als Prüfwert ein konkretes Feld des als Listeneintrag" wiederholten Entitätstyps adressiert werden, das per Definition "Kein Wert" ($null) als Wert ausschließt.

  • Für alle Entitätstypen kann das Feld "ID" (id) der wiederholten Entität mit $null verglichen werden, um zu prüfen ob die "Liste" mindestens einen Eintrag enthält oder nicht.
    
    

• Vordefinierte Entitätstypen können plurale Felder für Referenzen auf andere Entitäten - z. B. "Übergeordnete Firmen" (parentCompanies) für Firmen - vorsehen, die oberflächlich als Mehrfachauswahl (Multi-Combobox) und im Datenobjekt als Liste von Long-Werten abgebildet sind.

  • In diesem Fall kann als Projektion nur der Pfad für das "Listenfeld" (z. B. parentCompanies) ausgewählt werden. Als Prüfwert werden damit die als Einträge vorhandenen Long -Werte herangezogen. Ein Vergleich mit "Kein Wert" (==$null) gilt genau dann als bestanden, wenn kein Eintrag vorliegt. Die Umkehrung der Prüfbedingung (!=$null) ist erfüllt, wenn die "Liste" mindestens einen Long-Wert enthält.

  • ►ANMERKUNG◄ Für Eigene Typdefinitionen (bzw. Eigene Felder) steht kein generisches Konstrukt für eine plurale Referenz zur Verfügung. Insofern stellt dies einen Sonderfall dar.
    
    

• Ein "Listenfeld", das wie das attributes-Feld im Objektmodell Einträge unterschiedlicher Datentypen zusammenfasst, scheidet kategorisch als Prüfwert für eine Einschränkung aus.

  • Ein Vergleich kann in einer Datenbankabfrage nur als Einschränkung interpretiert werden, wenn die adressierte "Liste" mit genau einer konkreten Datenbanktabelle in Beziehung steht.

Die Konfiguration für die Einfache Feld-Einschränkung sieht kein Auswahlfeld vor, über das Aufzählungswerte als Vergleichswert ausgewählt werden könnten.

Trotzdem werden für eine Projektion, die einen Aufzählungswert als Prüfwert liefert, abhängig vom gewählten Vergleichstyp in bestimmten Fällen Vergleiche mit einer statischen Zeichenfolge als Vergleichswert unterstützt:

• Bezieht sich die Projektion auf ein Feld einer Entität, deren Datenstruktur einen eindeutigen Bezug zu einer statischen oder Dynamischen Aufzählung herstellt, wird für Vergleiche mit Vergleichstyp == , =,!= ,<, <=, > oder >= versucht, die als Vergleichswert angegebene Zeichenfolge in einen Wert der Aufzählung umzuwandeln. Sofern dies gelingt, wird als Prüfwert und als Vergleichswert der numerische Wert im Feld "Ordinal" (ordinal) für den jeweiligen Dynamischen Aufzählungswert herangezogen.

  • Die Typumwandlung gelingt, wenn eine statische Zeichenfolge angegeben ist, die exakt (inkl. Groß–/Kleinschreibung) mit dem internen Namen (name) eines Werts aus der betreffenden statischen oder Dynamischen Aufzählung übereinstimmt.

  • Scheitert die Typumwandlung, gelten Prüfwert und Vergleichswert für den Vergleichstyp ==, = oder != als nicht übereinstimmend. Für andere Vergleichstypen tritt ein Fehler auf.
    
    

• Bezieht sich die Projektion auf das Feld "Einheit" (unit) für ein Zahl mit Einheit Feld, wird für Vergleiche mit Vergleichstyp == , =,!= ,<, <=, > oder >= versucht, die als Vergleichswert angegebene Zeichenfolge in den Aufzählungswert für die entsprechende Einheit (s. Einheiten) umzuwandeln. Sofern dies gelingt, wird als Prüfwert und als Vergleichswert der Wert im Feld "Alias" (alias) für den zugehörigen Dynamischen Aufzählungswert herangezogen.

  • Die Typumwandlung gelingt, wenn eine statische Zeichenfolge angegeben ist, die exakt (inkl. Groß-/Kleinschreibung) mit dem Alias (alias) der Einheit (s. Einheiten) übereinstimmt.

  • Scheitert die Typumwandlung wird $null als Vergleichswert herangezogen und abhängig vom Vergleichstyp ausgewertet.
    
    

• Bezieht sich die Projektion auf das Feld einer Entität, deren Datenstruktur einen eindeutigen Bezug zu einer Dynamischen Aufzählung herstellt, wird mit Vergleichstyp like , not like, ilike oder not ilike die als Vergleichswert angegebene Zeichenfolge als Pattern für einen Mustervergleich herangezogen.

  • Für den Mustervergleich wird als Prüfwert die im Ausführungskontext anwendbare Lokalisierung für den von der Projektion bereitgestellten Dynamischen Aufzählungswert verwendet.

  • Der Mustervergleich interpretiert in der Zeichenfolge enthaltene Wildcard-Zeichen (_ und %). Ob die Groß-/Kleinschreibung berücksichtigt wird, entscheidet der Vergleichstyp.
    ►HINWEIS◄ Sofern für einen Dynamischen Aufzählungswert keine Lokalisierung existiert (weder für die Aktuelle Sprache noch für die Fallback-Sprache "Englisch"), wird der interne Name (name) als Prüfwert für den Mustervergleich herangezogen.

►WICHTIG◄ Die hier beschriebenen Szenarien beschreiben Konfigurationsmöglichkeiten, die zwar technisch machbar aber nur sehr eingeschränkt empfehlenswert sind.

• In einer Feld Einschränkung können Aufzählungswerte als Vergleichswerte über Wertauflöser der Kategorie Statische Werte "sauber" bereitgestellt werden (s. Jede statische Aufzählung, Jede dynamische Aufzählung und Einheit, ohne dass eine Typumwandlung ausgehend von einer Zeichenfolge beansprucht werden muss.
  
  

• Relative Vergleiche (mit Vergleichstyp < , <= , > oder >= ) mit Aufzählungswerten, die sich auf "Ordinal"-Werte beziehen sind generell kritisch zu beurteilen, da die Ordinals sich zwischen System (z. B. Test/Produktiv) unterscheiden können. Ander als bei einer Prüfung auf Übereinstimmung (mit Vergleichstyp ==, = oder !=) kann die "Sortierreihenfolge" und damit das Ergebnis eines Vergleichs also je System unterschiedlich ausfallen.
  
  

• Ein Mustervergleich (mit Vergleichstyp like , not like, ilike oder not ilike), der für Dynamische Aufzählungswerte obligatorisch auf die Lokalisierungstexte abzielt, funktioniert nur stabil, wenn zum Konfigurationszeitpunkt bekannt ist, welche Aktuelle Sprache zur Laufzeit gilt. Oder es wird konsequent auf Lokalisierungen für die betreffende Aufzählung verzichtet bzw. ausschließlich die Fallback-Sprache Englisch lokalisiert. Oder es werden nur Patterns geprüft, für die die verwendeten Lokalisierungen in allen Sprachen entweder treffen oder nicht. Solche Konventionen sind aber immer verletzlich und können erfahrungsgemäß nur durch große Disziplin oder erheblichen Regulierungsaufwand "in der Spur gehalten" werden.