Search (Form designer)
The Behaviour type Search (Form designer) executes a search in the Lobster Data Platform / Orchestration database (see also Search API) and returns the search results as a data service to the Actions on ‘true’.
In contrast to the Tuple search (Form designer), which queries a defined set of Projections, this search returns complete data objects including all references (attributes, etc.). As this involves a larger volume of data, searches tend to be less efficient in terms of performance than Tuple search (Form designer).
The button Configure search opens a dialog for search configuration.
With the option Return first result set, only the first match (if any) of the search is returned. Without this option, a list of all matches is returned.
If an element is linked to this behaviour type, which contains an object with properties and values, this data is provided to the context of the search as variables. For each data field specified for a child element, a variable bearing its name and value is created.
►IMPORTANT◄ If at runtime a linked element cannot be validated (see Validate element and Validators), e.g. because required fields are not filled in, the search is not executed and Actions on 'false' apply. These actions receive element data (to include 'invalid' inputs) from the linked element. If this element does not specify a data field, data of a parent level, if not the form itself, is provided.
The example describing the use of variables within searches on the page Tuple search (Form designer) applies correspondingly to Search (Form designer).