Suche (Formulardesigner)

Im Gegensatz zur Tupel Suche (Formulardesigner), die einen definierbaren Satz von Projektionen abruft, gibt die Suche komplette Datenobjekte inklusive der enthaltenen Referenzen (Attribute, usw.) zurück. Wegen des größeren Datenumfangs ist eine Suche in der Regel weniger performant als eine Tupel Suche (Formulardesigner).

• Der Button Suche konfigurieren öffnet einen Dialog zum Konfigurieren der Suche.

• Mit der Option Liefere erstes Ergebnis wird als Suchergebnis nur der erste Treffer (sofern vorhanden) zurückgegeben, ohne die Option eine Liste aller Treffer.

• Die Parameter Index von erstem Ergebnis und Seitengröße werden als Berechnungsausdrücke ausgewertet und dienen in erster Linie dazu Ergebnisse dynamisch einzugrenzen. Ein klassicher Anwendungsfall ist beispielsweise das Umsetzen eines Datenpagings.
  Diese beiden Parameter sind jeweils optional und überschreiben, wenn gegeben, die statischen Angaben "Erstes Ergebnis" und "Maximale Ergebnisse" in der Suchkonfiguration.
  Tipp: Der an die Aktionen weitergegebene Datenprovider beinhaltet ein Datenfeld namens serverOverallCount, welches die Gesamtzahl der Ergebnisse ohne Einschränkung beinhaltet.

Wird mit dieser Verhaltensweise ein Element verknüpft, bei dem es sich um ein Objekt mit Feldern und Werten handelt, sind dessen Daten in der Suche über Variablen verfügbar. Je Datenfeld eines Kind-Elements wird dabei eine Variable erzeugt, deren Name und Wert dem Datenfeld entsprechen.

►WICHTIG◄ Falls das verknüpfte Element zur Laufzeit nicht validiert werden kann (s. Element validieren und Validierer), etwa weil Pflichtfelder nicht ausgefüllt sind, unterbleibt die Suche und die Aktionen bei "falsch" werden ausgeführt. Für die Aktionen steht der "nicht valide" Bearbeitungsstand der Elementdaten des verknüpften Elements zur Verfügung. Sofern dieses nicht auf ein Datenfeld verweist, können das auch Daten einer übergeordneten Ebene bis hin zum Formular sein.

Das Beispiel für die Verwendung von Variablen innerhalb von Suchen im Kapitel Tupel Suche (Formulardesigner) ist sinngemäß auf die Suche (Formulardesigner) übertragbar.