Written by The Jahia Team
 
Developers
   Estimated reading time:

Augmented Search UI

Styling

How can I customize the styling of the Augmented Search UI?

Instant Search

How can I change the number of letters that trigger instant search?

How can I deactivate instant search?

Facets

Can I use hierarchical facets with categories?

Are facets conjunctive or disjunctive?

Can I index custom properties of type categories?

Can I display more than 5 elements in facets?

Search box

Can I use quotes to search for exact matches (for example, “my exact search”)?

Can I use boolean operators in the search box, for example AND, OR, or NOT?

Is autocomplete supported on terms that are most searched?

Search results

Can I display additional elements about a node that are not indexed in Elasticsearch ?

Highlighting

How does the highlighting work? Is there a match between the language used for lemmatization and the highlighting?

Answers

How can I customize the styling of the Augmented Search UI? 

You can customize the Augmented Search UI module by applying CSS from another template that defines the styling that you want to use. You can also fork the Augmented Search UI module.

How can I change the number of letters that trigger instant search?

In the Augmented Search UI module and in the SearchView.jsx file, modify the value for the debounceLength parameter in the SearchBox component.

<SearchBox
   searchAsYouType
   debounceLength={100}
/>

See search-ui SearchBox documentation for more information on the SearchBox component and parameters.

How can I deactivate instant search?

Just remove searchAsYouType from the SearchBox component in the SearchView.jsx file.

<SearchBox/>

See search-ui SearchBox documentation for more information on the SearchBox component and parameters.

Can I use hierarchical facets with categories?

In Augmented Search 1.0, hierarchical facets are not supported.

Are facets conjunctive or disjunctive?

Facets are disjunctive by default. Note that disjunctive facets enable users to select one or more facets to filter search results and conjunctive facets allow users to select only one.

Can I index custom properties of type categories?

No, only j:defaultCategory from jmix:categorized are indexed as such.

Can I display more than 5 elements in facets?

Augmented Searches uses Elastic's search-ui react components for displaying content, all of which are detailed in search-ui repository.

Displaying more than 5 elements is done through the "show" parameter.

Using this file as an example: src/javascript/app/SearchView/SearchView.jsx


  <facet 
    field="jcr:categories.keyword" 
    label="Categories" 
    show={10} 
  />

This will display up to 10 elements.

Can I use quotes to search for exact matches (for example, “my exact search”)?

No, using quotes to get an exact match is not supported by augmented search. However, if a search result matches the exact order of the searched words, it will be boosted automatically. 

Can I use boolean operators in the search box, for example AND, OR, or NOT?

No, boolean operators are not supported by augmented search.

Is autocomplete supported on terms that are most searched?

No, autocomplete is usually performed on terms that are the most relevant, rather than terms that are most used. 

How does the highlighting work? Is there a match between the language used for lemmatization and the highlighting?

Yes.

This will display up to 10 elements.

 

Can I use quotes to search for exact matches (for example, “my exact search”)?

No, using quotes to get an exact match is not supported by augmented search. However, if a search result matches the exact order of the searched words, it will be boosted automatically. 

Can I use boolean operators in the search box, for example AND, OR, or NOT?

No, boolean operators are not supported by augmented search.

Is autocomplete supported on terms that are most searched?

No, autocomplete is usually performed on terms that are the most relevant, rather than terms that are most used. 

Can I display additional elements about a node if such elements not indexed in Elasticsearch?

Yes, elements need to be indexed in Elasticsearch to be searchable, but if you are only interested in displaying additional information about a node and don't need it to be searchable, you can easily do it by calling Jahia GraphQL API directly from your front-end just after having fetched search results from Augmented-Search. Search results provide you with the UUID of the node, which makes calling the API to fetch more data straight forward.

Pay attention to performance considerations though when doing subsequent calls to fetch more data as it will (depending on your implementation) fetch data from the JCR for every search result currently displayed.

How does the highlighting work? Is there a match between the language used for lemmatization and the highlighting?

Yes.