:title: Viewing Search Results
:type: subUsing
:status: published
:parent: Searching {catalog-ui}
:summary: Viewing search results
:order: 02

== {title}

The *Search* tab displays a list of all of the search results for the selected search.

Returned search results can be refined further, bookmarked, and/or downloaded from the *Search* tab.
Result sets are color-coded by source as a visual aid.
There is no semantic meaning to the colors assigned.

.Search Results Options
image::search-results-options.png[search results options]

. On the *Search* tab, select a search from the drop-down list.
. Perform any of these actions on the results list of the selected search:
.. *Filter* the result set locally. This does not re-execute the search.
.. *Sort* (Customize results sorting). The default sort is by title in ascending order.
.. Toggle results view between *List* and *Gallery*(displays a thumbnail, if applicable).

=== Search Result Options

.Options for each individual search result
* *Download*: Downloads the result's associated resource directly to the local machine. This option is only available for results that have resources.
* *Add to List* &#43;: Adds/removes the results to/from a list.
* [[_hiding_a_result]]*Hide from Future Searches*: Adds to a list of results that is hidden from future searches.
* *Expand Metacard View*: Navigates to a view that only focuses on this particular result.
* *Export As*: Export the metadata, associated resource, or both.

=== Adding Visuals

((*Visuals*)) allow different views of search results.

. Click the *Add Visual* (image:add-visual-icon.png[add visual icon]) icon in the bottom right corner of {catalog-ui}.
. Select a visual to add.
.. *2D Map*: A 2 dimensional map view.
.. *3D Map*: A 3 dimensional map view.
.. *Histogram*: A configurable histogram view for the results of a search.
.. *Table*: A configurable table view for the results of a search.
.. ((*Inspector*)): [[_inspector]]In depth details and actions for the results of a search.

.Inspector View Available Options
* *Summary*: A customizable subset of the attributes of the result.
** *Filter*: Search for specific attributes.
** *Actions*: *Add*, *Remove*, *Show*, or *Rearrange* the visible attributes for this result.
* *Details*: A detailed view of all attributes available for the result.
* <<_viewing_revision_history,History>>: View revision history of this record.
* <<_editing_associations_on_a_record,Associations>>: View or edit the relationships between this record and others in the catalog.
* <<_viewing_metadata_quality,Quality>>: View the completeness and accuracy of the metadata for this record.
* <<_exporting_a_result,Actions>>: Export the metadata/resource to a specific format.
* <<_archiving_a_result,Archive>>: Remove the selected result from standard search results.
* <<_overwriting_a_resource,Overwrite>>: Overwrite a resource.

==== Editing Records

Results can be edited from the *Summary* or *Details* tabs in the *Inspector* visual.

==== Viewing Text Previews

If a preview for a result is available, an extra tab appears in the *Inspector* visual that allows you to see a preview of the resource.

Getting a preview using the metadata can be enabled through *{admin-console} -> Catalog -> Configuration -> Catalog Preview -> Preview From Metadata*

==== Editing Associations on a Record

Update relationships between records through [[_associations]]((*Associations*)).

. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select the *Associations* tab.
. Select *Edit*.
. For a new association, select *Add Association*. Only items in the current result set can be added as associations.
.. Select the related result from either the *Parent* or *Child* drop-down.
.. Select the type of relationship from the *Relationship* drop-down.
.. Select *Save*.
. To edit an existing association, update the selections from the appropriate drop-downs and select *Save*.

View a graphical representation of the associations by selecting *Graph* icon from the *Associations* menu.

.Associations menu.
image::associations-menu-icon.png[associations menu]

==== Viewing Revision History

View the complete revision history of a record.

. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select the *History* tab.
.. Select a previous version from the list.
.. Select *Revert to Selected Version* to undo changes made after that revision.

==== Viewing Metadata Quality

(((Metadata Quality)))
View and fix issues with metadata quality in a record.

[NOTE]
====
Correcting metadata issues may require administrative permissions.
====

. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select the *Quality* tab.
. A report is displayed showing any issues:
.. Metacard Validation Issues.
.. Attribute Validation Issues.

==== Exporting a Result

Export a result's metadata and/or resource.

. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select *Actions* tab.
. Select the desired export format.
. Export opens in a new browser tab. Save, if desired.

==== Archiving a Result

To remove a result from the active search results, archive it.

. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select the *Archive* tab.
. Select *Archive items*.
. Select *Archive*.

==== Restoring Archived Results

Restore an archived result to return it to the active search results.

. Select the *Search Archived* option from the *Search Results Options* menu.
. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select the *Archive* tab.
. Select *Restore items*.
. Select *Restore*.

Restore hidden results to the active search results.

. Select the *Settings* (image:gear-icon.png[settings]) icon on navigation bar.
. Select *Hidden*.
. Click on the eye (image:eye-icon.png[]) icon next to each result to be unhidden.
.. Or select *Unhide All* to clear the list.

image::unhide-blacklist.png[unhide blacklist]

See <<{using-prefix}hiding_a_result,Hiding a result>>.

==== Overwriting a Resource

Replace a resource.

. Select the desired result from the *Search* tab.
. Select the *Inspector* visual.
. Select the *Overwrite* tab.
. Select *Overwrite content*.
. Select *Overwrite*
. Navigate to the new content via the navigation window.
