Die rechts abgebildete Setze Werte-Ereignisaktion wurde dem "Suche anpassen"-Bock über das Kontextmenü für das -Symbol (siehe oben) hinzugefügt. Sie definiert zwei Zuweisungen:

• Die erste Zuweisung weist dem Feld "Erstes Ergebnis" (firstResult) der auszuführenden "Suche" den Wert der Variablen firstResult zu.
  
  

• Die zweite Zuweisung weist dem Feld "Maximale Ergebnisse" (maxResults) der auszuführenden "Suche" den Wert der Variablen maxResults zu.

►HINWEIS◄ Da kein Zielobjekt definiert ist, beziehen sich die Objekt-Feld-Wertauflöser für die Zielwerte (links im Bild) auf die konfigurierte "Suche", die das Bezugsobjekt im "Suche anpassen"-Block gilt.

Der Entitätstyp dieses Bezugsobjekts hängt davon ab, welche der Sucharten im Parameter "Suche" (s. oben) ausgewählt ist. Die Beschriftung im Kopf des "Suche anpassen"-Blocks variiert entsprechend ("Suche anpassen", "Tupel-Suche anpassen" oder "CSV-Suche anpassen").

Der Screenshot rechts zeigt die Konfiguration für Ereignisaktionen im "Suche anpassen"-Block einer Suche (Ereignisaktion), die eine "CSV-Suche" ausführen soll:

• Innerhalb der Setze Werte-Ereignisaktion wird als Zielobjekt per Erzeuge Instanz eine Einfache Feld-Einschränkung erzeugt und über den verketteten Wert als Variable speichern-Wertauflöser in die Variable filter gespeichert.
  
  

• Es folgen drei Wertzuweisungen an Felder der neu angelegten Einfache Feld-Einschränkung-Instanz:
  
  

  • Dem Feld "Projektion" (projection) wird der Wert zugwiesen, den die Variable propertyName bereitstellt.
    
    

  • Dem Feld "Vergleichstyp" (compareType) wird der Schlüsselwert ilike als statischer Text zugewiesen. Das ist der Vergleichsoperator für Groß-/Klein-indifferente Textmuster.
    
    

  • Dem Feld "Zeichenfolge" (stringValue) wird der Wert der Variable beginsWith verkettet mit dem statischen Textwert % (Wildcard für eine beliebige Anzahl an Zeichen) zugewiesen. Diese Verknüpfung erzwingt eine Übereinstimmung "Am Anfang" des Werts aus dem per propertyName adressierten Feld.
    
    ►ANMERKUNG◄ Wir berücksichtigen hier nicht den Sonderfall, dass der Wert aus der Variable beginsWith Zeichen enthält, die im Kontext der Datenbank "maskiert" werden müssten (z. B. Wildcard-Zeichen wie % oder _).
    
    

• Nachdem die Einfache Feld-Einschränkung erzeugt und parametrisiert ist, wird sie in der folgenden Setze Wert-Ereignisaktion als Ganzes dem Feld "Bedingung" (where) der Suche zugewiesen. Diesen Zugriff ermöglich die Variable filter, die eine Referenz auf das erzeugte SimplePropertySearch-Objekt enthält (s. Wert als Variable speichern oben).

►HINWEIS◄ Falls die Konfiguration für die "Bedingung" der CSV-Suche doch eine oder mehrere (statische) Einschränkungen vorsehen sollte, überschreibt unsere Zuweisung diese komplett. Soll die erzeugte Einschränkung zusätzlich zu bestehenden Einschränkungen berücksichtigt werden, muss eine Such-Verknüpfung angepasst oder erzeugt werden, um je nach Bedarf entweder eine UND- oder eine ODER-Beziehung herzustellen.

Der Screenshot rechts zeigt die Konfiguration für eine Suche (für die Entität Firmen) innerhalb einer Suche (Ereignisaktion), die eigentlich nur dazu dient, im Kontext einer Ereignisbehandlung ein Search-Objekt zu erzeugen, das anschließend einer Öffne View (Aktion) als Filterbedingung für die zu öffnende View genutzt werden soll.

►ANMERKUNG◄ Da die Ausführung der Suche nicht verhindert werden kann wir sie hier so konfiguriert, dass sie möglichst wenig Daten erzeugt. Als Modus ist deshalb "Erstes Ergebnis" ausgewählt, sodass in die Variable dummy als Rückgabewert nur ein oder kein Firmenkonto gespeichert wird.

• Der wertgebende Bestandteil dieser Suche ist die mehr oder weniger komplexe Bedingung. Konkrete Details zu deren Inhalt sind nicht von Belang. Hinter der im Bild erkennbaren UND-Verknüpfung kann sich ein umfangreiches und mehrfach verschachteltes logisches Aggregat verstecken.
  
  

• Im Suche anpassen-Block weist eine Setze Wert-Ereignisaktion die dort als Bezugsobjekt vorliegende "Suche" einer Variablen mySearch zu, auf die im Unterschied zur vom System verwalteten entity-Variablen auch nach dem Ausführen der Suche von außerhalb des "Suche anpassen"-Blocks nachfolgenden Ereignisaktionen zugegriffen werden kann.
  
  

►WICHTIG◄ In der nachfolgenden Öffne View (Aktion)-Ereignisaktion wird auf das Search-Objekt als Ganzes zugegriffen. Dabei wird die im where-Feld definierte Bedingung nicht direkt als Einschränkung für die geöffnete Übersicht übernommen. Vielmehr wird aus der Definition der Suche insgesamt eine Sub-Suche-Einschränkung erstellt, die mit einer ggf. bestehenden "Einschränkung" für die zu öffnende View (s. Eigene Übersichten) UND-verknüpft wird. Diese Vorgehensweise mag unnötig kompliziert erscheinen, stellt aber u. a. sicher, dass die Bedingung in der übergebenen Suche auch Einschränkungen verwenden kann, die Felder aus Joins adressieren. Auch die einschränkende Wirkung von INNER Joins kann nur indirekt - per "Umweg" über die Sub-Suche-Einschränkung - auf die Zu öffnende View übertragen werden.

Die rechts abgebildete Öffne View (Aktion)-Ereignisaktion öffnet eine Standard-"Firmenübersicht", für die die "Bedingung" aus dem Search-Objekt in der Variablen mySearch als "Einschränkung" gilt, wenn im Parameter Formulardaten der Wert dieser Variablen als Search-Objekt aufgelöst wird.

►WICHTIG◄ Falls in der Suche (Ereignisaktion) in der Variablen mySearch anstelle der Suche eine Tupel-Suche oder CSV Suche definiert wäre, würde die adressierte Firmenübersicht geöffnet aber nicht auf Grundlage der Suche eingeschränkt.

Es ist wichtig zu verstehen warum: Öffne View (Aktion) versucht nur dann aus dem Parameter Formulardaten eine Restriktion für die Zu öffnende View abzuleiten, wenn sein Wert dem Typ "Suche" (Search) oder "Sucheinschränkung" (ISearchRestriction) entspricht. Ein TupleSearch-Objekt würde diesen Test nicht bestehen. Die dann anwendbare Standardbehandlung für Formulardaten (s. Öffne View (Aktion) ergibt keine Auswahl (mangels ID-Feld auch keine unbeabsichtigte) einer Entität im Kontext der geöffneten Übersicht.