Bug 27448 - Update ElasticsearchCrossFields description to explain consequences of setting in Koha
Summary: Update ElasticsearchCrossFields description to explain consequences of settin...
Status: NEW
Alias: None
Product: Koha
Classification: Unclassified
Component: System Administration (show other bugs)
Version: Main
Hardware: All All
: P5 - low enhancement (vote)
Assignee: Bugs List
QA Contact: Testopia
URL:
Keywords:
Depends on: 27252
Blocks:
  Show dependency treegraph
 
Reported: 2021-01-16 12:26 UTC by Katrin Fischer
Modified: 2023-09-06 12:36 UTC (History)
5 users (show)

See Also:
Change sponsored?: ---
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Katrin Fischer 2021-01-16 12:26:25 UTC
The description of the ElasticsearchCrossFields is technical correct, but for someone configuring Koha, it's not clear what the settings mean for using Koha. What's the consequence of choosing one setting or the other? It's only clear that you will need to use a specific Elasticsearch version.
Comment 1 Katrin Fischer 2022-07-15 15:25:19 UTC
It has a link to documentation that's not a link too :)

https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-multi-match-query.html#type-cross-fields
Comment 2 Nick Clemens 2022-08-01 15:10:43 UTC
In Koha, a 'keyword' search does not search a cpombined 'keyword' field, but rather searches your term across all the fields marked as 'searchable' in the current interface.

Cross fields is used to determine whether you want to only return values where all entered terms are included in a single search field, or whether you wish to find a record with all terms, but allowing the terms to be in any combination of fields.

e.g.
"king grass"

without cross fields will return:
The Island of the Grass King by Nancy Willard (grass in title/king in title)

with cross fields will return:
The Island of the Grass King by Nancy Willard (grass in title/king in title)
In the tall grass by Stephen King (grass in title/king in author)
Comment 3 Caroline Cyr La Rose 2023-09-05 20:08:18 UTC
I have just had a problem of a client disabling this (not sure why) and then their searches weren't returning the results they expected.

I liked the description here https://bywatersolutions.com/education/elastic-search-configuration

"More specifically, on Elastic 6 and later, if ElasticsearchCrossFields is turned off, Koha will look for all of your search terms in all of your search indices, but only return titles where all of your terms were in the same index. So a search for "bram stoker dracula" would not find the novel (as "bram stoker" is in the author and "dracula" is in the title), but might find you the 1992 film titled Bram Stoker's Dracula."

For now, I added more info in the manual. Nick, I hope it's OK with you that I reused your example. https://gitlab.com/koha-community/koha-manual/-/merge_requests/733
Comment 4 Nick Clemens 2023-09-06 12:36:12 UTC
(In reply to Caroline Cyr La Rose from comment #3)
> For now, I added more info in the manual. Nick, I hope it's OK with you that
> I reused your example.
> https://gitlab.com/koha-community/koha-manual/-/merge_requests/733

Of course! Thank you!