Search - using Elasticsearch (or OpenSearch)

Search and Filtering

In Inventory, we have implemented a button group to toggle between searching on the instance, holdings, or item level.

Search and filter options can be combined.

Search in the Instance segment supports search on bibliographic data.

Search in the Holdings and Item segments are a combination of key data from the Instance record, combined with holdings and item specific data elements. 

Search / filter options in Orchid

Query Search using CQL (Instance, Holdings, Item segment)

For Kiwi the Query Search functionality (CQL) is limited to be only indexes supported by mod-search (Elasticsearch/OpenSearch). 

 (Please note that this page defaults to the master list, which may differ from your version of mod-search. To find your version of mod-search, in Folio go to Settings→Software versions, then look for mod-search. On the github page, there is a drop-down menu at the top that you can choose your version from.)

Supported search options

Examples

Using boolean operators in Query Search (AND, OR, NOT)

When using Query Search, you can combine search terms with Boolean operators (AND, OR, NOT). 

You can also search on e.g. multiple ISBNs; e.g. Query search: isbn=9780763653378 OR isbn=0312087608 OR isbn=9781938461026 in Bugfest Orchid:

https://bugfest-orchid.int.aws.folio.org/inventory?qindex=querySearch&query=isbn%3D9780763653378%20OR%20isbn%3D0312087608%20OR%20isbn%3D9781938461026&sort=title

Query search also supports search on primary contributors; e.g. Query search:  contributors all "John" and contributors.primary==true in Bugfest Orchid:

https://bugfest-orchid.int.aws.folio.org/inventory?qindex=querySearch&query=contributors%20all%20%22John%22%20and%20contributors.primary%3D%3Dtrue&sort=title

Using Filter/Facets

When doing a search, then you can narrow down the search by using the filter/facet. Once you click on a filter/facet, you will only see the results that are relevant to your search. E.g., if you click the Effective location filter, it will only show you the locations contained in your search results, not the entire list of possible locations.

You can also choose to only use the filter/facets. E.g. get the result of all books in the collection in Swedish.

Search across all data properties

With elasticSearch, we can search across all three record types (instance, holdings, item) on values in any property. This is disabled by default, and must be turned on by your hosting provider or systems administrator.

Note that because this is disabled by default, it is not enabled on any of the reference environments.

Example: cql.all all "web semantic"

Advanced search (pending development)

Here some new UX mock ups for how Advanced search is envisioned, and expected to be implemented consistently across all apps supporting advanced search:

Examples that Advanced search will support:

• cql.allRecords=1 NOT contributors=Smith matches all records where contributors name does not contain Smith as a word
• cql.allRecords=1 NOT name="" matches all records where name is not defined.
• cql.allRecords=1 NOT name=="" matches all records where name is defined and not empty or where name is not defined.

Browsing 

• Call numbers
• Subject

See UX-mock ups (Work in progress) 

Querying date fields

The instance record has several different types of data fields. 

Instance date fields - dateOfPublication and publicationPeriod

• publication.dateOfPublication
  • if record was created by data import from MARC bibliographic, this field is controlled by the underlying MARC SRS record - see Default MARC Bibliographic-to-Inventory Instance Mappings
• publicationPeriod.start and publicationPeriod.end
  • publicationPeriod is meant to support sorting search results by publication date. It is a derived value field based on the values in dateOfPublication - see MODINVSTOR-724 - Getting issue details... STATUS for requirements on how start and end are populated based on dateOfPublication

Instance, Holdings and Item date fields - metadata object

• Metadata
  • This is a standard object present for almost all FOLIO records that tracks the FOLIO account that created the record, the FOLIO account that last updated the record, the date/time the record was created, and the date/time the record was last updated

Tips for searching

Quotations marks will generally be added for you, but you can also type them yourself. If you make a mistake typing and go back to edit, you may need to enter the quotation marks manually.

Occasionally you might have to play around a bit with the space bar and re-enter have gone back to edit something.

If you only want to do a keyword search, you can simply enter the search term.

Documentation on GitHub

Documentation on GitHub - see here

Search across all data elements - see here