SearchResults/SearchResultsLinked/SearchResultsSelect

The SearchResults header is displayed between the search mask and the results list. For linked searches the SearchResultsLinked header is used, if available (fallback: SearchResults).

This header usually contains the text "Search Results" and allows users to navigate within the result list. This header may also contain buttons, >> Header Buttons. If the user clicks a button in the SearchResults header, the button's action is executed on the record(s) selected in the list. The linked record (or parent record) referenced in the action is the page's (optional) linked record. For a more detailed explanation, >> Defining an Action.

The SearchResults header contains a standard New button to create a new record of the same type with the same link (if a linked record exists). This button uses calls the ExpandNew action with the infoAreaId parameter for the record's info area and the link parameter as link for the new record, >> Expand.

When using this standard New button in the SearchResults header, you cannot use that header for both a search started from the application menu and a search started from a context menu for most info areas: Child info areas need a linked record, e.g. a company or person, which is not available from the application menu. In this case you need two different SearchResults headers: one for the action called from the context menu containing the standard New button, and one when the page is called from the application menu containing a New button launching a process or not containing a button.

To implement two different headers, either define two Search&List configurations or define an alternate SearchResults header in the Search action.

Example in UPDATE_DEFAULT: When creating a new activity (MA) from the application menu, the SearchResults header of header group MA is used. The New button in this header launches the NewAppointment process, where the user has to select a parent record for the activity.

When creating a new activity from a context menu (e.g. via A_AllAppointments in M_Company), the SearchResults header of header group MA-KP,FI is used. This header contains the standard New button described above.

If a Search action is called within a process and no special SearchResults header is defined replacing the standard SearchResults header, the SearchResultsSelect header is used.

Example in UPDATE_DEFAULT: The SearchResultsSelect header in header group KP contains two buttons: The WizardNew button fires event 2, the WizardSearchViaCompany button fires event 3.