Difference between revisions of "Advanced search"

From ICA-AtoM
Jump to navigation Jump to search
Line 1: Line 1:
<span class="pageTitle">Browse content</span>
+
<span class="pageTitle">Search: advanced</span>
  
[[Main Page]] > [[User manual|(UM) User manual]] > [[UM-4|UM-4 Access content]] > UM-4.2 Browse content
+
[[Main Page]] > [[User manual|(UM) User manual]] > [[UM-4|UM-4 Access content]] > UM-4.2 Search: advanced
  
[[Image:um4-2BrowseBox.png|500px|right|thumb|Browse box: select filter]]
 
  
[[Image:um4-2BrowseList.png|500px|right|thumb|Browse box: matches list screen]]
+
ICA-AtoM uses the [http://framework.zend.com/ ''Zend''] framework's implementation of the the [http://lucene.apache.org/ ''Lucene''] search engine. This provides a number of options for advanced searching from within the [[Glossary#Search box|Search box]]. For a full description of the features supported by Zend's Lucene search, see:
  
[[Image:um4-2BrowseResults.png|500px|right|thumb|Browse box: matches list screen]]
+
*[http://framework.zend.com/manual/en/zend.search.lucene.query-language.html Zend Programmers Reference Guide, chapter 33.4: Zend_search_Lucene > Query language].
  
 +
What follows is a selection of some of the most commonly used tools.
  
Use the [[Glossary#Browse box|Browse box]] to view records in ICA-AtoM by various filters.
 
  
 +
'''Phrases'''
  
1. Select a filter in the [[Glossary#Browse box|Browse box]] from the drop-down menu.
+
*Use double quotes ("searchTerm") to search phrases.
  
 +
*E.g. Search ''"city hall"'' to return records containing these two words together in that exact order.
  
2. Click the [[Glossary#Browse button|Browse button]].
 
  
 +
'''Boolean operators'''
  
3. ICA-AtoM retrieves all the relevant records and displays them on a [[Glossary#List screen|List screen]].
+
*Use AND to combine search terms to '''narrow''' your search: e.g. search ''vancouver AND "city hall"'' to return only descriptions that contain '''both''' search terms.
  
 +
*Use OR to to combine search terms to '''broaden''' your search: e.g. search ''vancouver OR "city hall"'' to return descriptions that contain '''either''' search term.
  
4. To sort the list, click the [[Glossary#Column header|column header]] you want to sort by; click again to reverse sort.
+
*Use NOT to '''exclude''' terms: e.g. search ''vancouver NOT "city hall"'' to return descriptions that include ''vancouver'' but do '''not''' contain the phase ''"city hall"''.
  
 +
*Boolean operators can be upper- or lowercase.
  
5. Each [[Glossary#Filter|filter]] is described below:
+
*You can substitute symbols for words: && (AND), || (OR), ! (NOT).
  
 +
*Other Boolean operators are available; see [http://framework.zend.com/manual/en/zend.search.lucene.query-language.html Zend's documentation].
  
'''Subject'''
 
  
*Returns all [[Glossary#Term|terms]] included in the [[Glossary#Taxonomy|Subject taxonomy]].
+
'''Fields'''
  
*"Results" column returns the number of times the term has been used as a [[Glossary#Access point|subject access point]] to an [[Glossary#Archival description|archival description]].
+
*You can restrict your search to specific fields by typing the field name followed by a colon ( : ) and the search text (''fieldName:searchText'').
  
*Click the [[Glossary#Term|term]] to get the "results" ([[Glossary#Archival description|archival descriptions]] using it as an [[Glossary#Access point|access point]]) on a new [[Glossary#List screen|List screen]].
+
* E.g. search ''title:city'' to return descriptions which include the word ''city'' in the title.
  
 +
*You must enter the exact field name. These are not always intuitive nor do they necessarily correspond to the field label that appears on screen.
  
'''Place'''
+
*For the list of searchable fields and their names, see in this manual: [[UM-4.1.1|Field names for advanced searching]].
 
 
*Returns all [[Glossary#Term|terms]] included in the [[Glossary#Taxonomy|Place taxonomy]].
 
 
 
*"Results" column returns the number of times the term has been used as a [[Glossary#Access point|place access point]] to an [[Glossary#Archival description|archival description]].
 
 
 
*Click the place [[Glossary#Term|term]] to get the "results" ([[Glossary#Archival description|archival descriptions]] using it as an [[Glossary#Access point|place access point]]) on a new [[Glossary#List screen|List screen]].
 
 
 
 
 
'''Name'''
 
 
 
*Returns all entities registered in the [[Glossary#Authority file|Authority file]] ([[Glossary#Authority record|authority records]]).
 
 
 
*"Type" column indicates the type of entity (''Corporate body, Person, Family'').
 
 
 
*Click the name to go to the full [[Glossary#Authority record|authority record]] ([[Glossary#View screen|View screen]]).
 
 
 
 
 
'''Archival institution''
 
 
 
*Returns all repositories registered as [[Glossary#Archival institution|archival institutions]].
 
 
 
*"Type" column indicates the type of repository (e.g. ''Municipal, University'').
 
 
 
*Click the institution name to go to the full [[Glossary#Archival institution|archival institution]] record ([[Glossary#View screen|View screen]]).
 
 
 
 
 
'''Media type'''
 
 
 
*Returns all [[Glossary#Term|terms]] included in the [[Glossary#Taxonomy|Media taxonomy]].
 
 
 
*"Results" column returns the number of [[Glossary#Digital object|digital objects]] of that type that are stored in the application.
 
 
 
*Click the media [[Glossary#Term|term]] to get the "results" ([[Glossary#Digital object|digital objects]]).
 
 
 
<br clear="right">
 
<span class="revised">Last revised: 3 June 2008 (ICA-AtoM v0.6)</span>
 

Revision as of 17:25, 13 June 2008

Please note that ICA-AtoM is no longer actively supported by Artefactual Systems.
Visit https://www.accesstomemory.org for information about AtoM, the currently supported version.

Search: advanced

Main Page > (UM) User manual > UM-4 Access content > UM-4.2 Search: advanced


ICA-AtoM uses the Zend framework's implementation of the the Lucene search engine. This provides a number of options for advanced searching from within the Search box. For a full description of the features supported by Zend's Lucene search, see:

What follows is a selection of some of the most commonly used tools.


Phrases

  • Use double quotes ("searchTerm") to search phrases.
  • E.g. Search "city hall" to return records containing these two words together in that exact order.


Boolean operators

  • Use AND to combine search terms to narrow your search: e.g. search vancouver AND "city hall" to return only descriptions that contain both search terms.
  • Use OR to to combine search terms to broaden your search: e.g. search vancouver OR "city hall" to return descriptions that contain either search term.
  • Use NOT to exclude terms: e.g. search vancouver NOT "city hall" to return descriptions that include vancouver but do not contain the phase "city hall".
  • Boolean operators can be upper- or lowercase.
  • You can substitute symbols for words: && (AND), || (OR), ! (NOT).


Fields

  • You can restrict your search to specific fields by typing the field name followed by a colon ( : ) and the search text (fieldName:searchText).
  • E.g. search title:city to return descriptions which include the word city in the title.
  • You must enter the exact field name. These are not always intuitive nor do they necessarily correspond to the field label that appears on screen.