Admin: Search Tab

The Search tab on the administration interface contains fields that allow you to:

      Define where to begin the search

      Show or hide the Search box

      Require the user to enter search criteria before results are displayed

      Define a required search, in which you define the criteria for the data to be displayed and remove the user's ability to perform a search

      Configure the Search box to present a drop-down list of criteria to select from, instead of allowing a free-form search

When you are finished making your selections on this tab, click any other administration tab to save your changes and keep the administration interface open, or click OK to save your changes and return to the roll-up display.

Wait for Search

When this feature is enabled, the web part will not return any results until the user completes a search. It can save much-needed performance when accessing multiple lists and/or sites. With some configuration, this allows you to have multiple roll-ups on a page, each pointing a different list with a different schema, and utilizing a form web part or another connected web part as a search mechanism for all roll-ups on that page. This option was previously named “Show Nothing At Startup.”

Required Search Criteria

(Optional) Users are permitted to search for specific phrases to return only the information that pertains to them. However, administrators can deactivate this feature by placing a valid search phrase in this field. When this is done, the web part will return the items found via the search phrase. The fields that can be utilized in this search string are identified in the Supported Schemas section of this help, on the “Search Fields” line of each identified schema.

NOTE: If anything is entered in this field, the Search function will be deactivated for general users.

List URL

The Search box provided in a roll-up display can be configured to present a drop-down list of criteria to select from, instead of allowing a free-form search.  The List URL field is used to define the site from which this list of criteria is pulled.

The list can be located anywhere in the system. If the list exists within the same site as this web part, you can leave the Site URL field blank. As an example, say you have a list of customers located in your Sales Department sites.  In your Customer Service site, you track the calls from customers.  You can configure a roll-up view in Customer Service to include a search box that provides a drop-down list of customers that comes from the Sales Department site.

List Name

This field should state the Display Name of the list that you want to use to populate the set of available search criteria. The Display Name is the name displayed in the "Documents and Settings" area of SharePoint; it is not the URL name of the list.

NOTE: The %user% function is not supported in the administration interface. If you wish to see a list of users from the site you have chosen as a site URL or the current site, you can use the %user% parameter in the web part properties tool pane.

List Field Name

Enter the name of the field that you want to use to populate the search drop-down. The web part will look at all results within the list and return items from that list field, removing any duplicates.

NOTE: Keep in mind that this field is referenced to determine the values displayed in the search drop-down. This is not the name of the field that will be searched when the search is executed; searches look at all searchable fields identified in the schema. If you are working with a custom schema, the searchable fields are the ones you identified in the “Search” column in the Roll-Up Wizard.