.. _search_concept:

Search: Overview
----------------

A search input box is always available to allow the user to search quickly
for items. The default search context is across all components on the system
that the user has permission to view as specified in their Access Profile, with
the caveats on number of items, relations and device models listed below.

For a simple, entered string, the search matches the start of the text of a
component.


.. note::
   
   * Search result lists are limited to a maximum of 1,000 items.
     A message will show at the bottom of the list pages to indicate this.
     Use a more specific search query for result lists of more than 1,000 items.
   * Simple search strings will match values in data and device models (relations
     instances will not be returned).
     To search the relation model instances, specify the model as a part of the
     query - refer to the search syntax.
   * Selecting a data or device model instance returned in a search will display
     the full model details, in other words, without a Field Display Policy applied.
     


.. _carry_out_a_search:

Carry Out a Search
..................

#. Choose a hierarchy from which to carry out the search.
#. Enter a search string (using the search syntax) in the **Search** text box.
   By default, sub-string matches of the string will be searched for. This means
   that a search for "Site" will also show "Site2" in the result list.
#. Press **Enter** on the keyboard. Search results are shown in the list view.


.. _perform_an_action_on_the_search_result_set:

Perform an Action on the Search Result Set
..........................................

To perform an action on the search result set:

Click an entry in the list view to open the result instance, or select a specific
check box and click one of the buttons on the button bar, such as **Delete**, or
select one of the options from the **Action** drop-down, such as **Export** or **Tag**
to carry out the associated task. The buttons and options available are dependent
on the access profile of the user performing the search.

To select multiple entries, select all the relevant check boxes. 

.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM