Setting up Real-Time Search for Fluid Components

For classic components, the system automatically builds the component search page displayed to a user, with no additional effort required by the application developer. The system uses built-in logic to create the component search page on the fly based on the search keys defined on the search record for the component.

In the fluid user interface, the real-time component search page is not populated automatically by the system. For any custom fluid component that requires real-time, component search capabilities, the application developer must create a pivot grid, using the component as the data source. The pivot grid generates the underlying query using the search keys defined on the records in the component and populates the search page. See Pivot Grid: Creating a Component Pivot Grid Model Using the Pivot Grid Wizard for creating a component-based pivot grid for use with implementing real-time search for a fluid component.

Creating a Pivot Grid for Real-Time Search

When creating a pivot grid for real-time fluid component search, keep these items in mind while using the Pivot Grid Wizard:

  • Make sure the pivot grid Data Source Type is set to Component and the Component Name under Data Source reflects your fluid component on Step 1 of the wizard.

  • Make sure the Default View is set to Chart Only under View Options on Step 4 of the wizard.

  • Under Fluid Mode, Viewer Options on Step 4 of the wizard, select either Grid and List or List for Result View if you intend to use the Master - Detail search page type or you intend for the search results to be displayed on a small form factor. Selecting Grid is a valid option for the Standard search page type and if the fluid component would not be accessed by small form factor devices.

Setting Search Defaults for Real-Time Search

In a fluid component when search is enabled and an end user accesses the component, the system displays search results on the search page using the default search criteria provided by the application developer. If you do not provide default search criteria, the system displays an empty page, which may detract from the user experience.

When creating a pivot grid for real-time component search, you can provide default search criteria using these options:

  • In the Pivot Grid Wizard, enter the desired values under Select Query Prompt Values in Step 3.

  • In Application Designer on the Record Field > Use tab, set a Default Value for a search key in the search record.

  • Use SearchInit PeopleCode to set a search record value to a particular value (RECORD_NAME.FIELD_NAME=value;).

Note:

If you are using multiple options for setting default search criteria, the system imposes this order of precedence: SearchInit PeopleCode takes precedence over Record Field Default Value settings, and Record Field Default Value settings take precedence over any Query Prompt Values set in the pivot grid definition.

Related Topics