Page 1 of 1

Keyword versus indexterm

Posted: Fri Oct 19, 2018 11:12 am
by ann.jensen
Hi,
I have been including <indexterm> elements within the prolog element for each of my topics.
I had assumed that these would be used by Oxygen WebHelp search but am realising that is not the case now.
Should I be putting both <indexterm> and <keyword> elements in my <prolog>?
Regards,
Ann

Re: Keyword versus indexterm

Posted: Mon Oct 22, 2018 9:12 am
by radu_pisoi
Hi,

You can use either indexterm or keyword element in the topic's prolog to increase the word scoring for WebHelp search function.

I have tested with WebHelp Responsive 20.1 inserting an indexterm in a topic's prolog:

Code: Select all


<prolog>
<metadata>
<keywords>
<indexterm>gardening</indexterm>
</keywords>
</metadata>
</prolog>
You can read more about How to Change Element Scoring in Search Results in our documentation.

Re: Keyword versus indexterm

Posted: Mon Oct 22, 2018 10:25 am
by ann.jensen
Hi,
Thanks for your reply. I have tested this using indexterm in Oxygen 19.1

Code: Select all

  <prolog>
<metadata>
<keywords>
<indexterm>Work Order Scheduling</indexterm>
<indexterm>Task Scheduler</indexterm>
</keywords>
</metadata>
</prolog>
After publishing to WebHelp and doing an exact search for the words "Task Scheduler" in double quotes, I get no results.
I can see the term in the generated index but it doesn't appear to be used by the search.
Is this because I am using an older version?
Regards,
Ann

Re: Keyword versus indexterm

Posted: Wed Oct 24, 2018 3:03 pm
by radu_pisoi
Hi,

The phrase search (for example, "grow flowers") return results only if words are found consecutively in the document, the consecutive words from index terms are not analyzed.

I will register this improvement in our internal issue tracker.

Re: Keyword versus indexterm

Posted: Wed Oct 24, 2018 5:14 pm
by ann.jensen
Hi Radu,
Thanks for that. if I don't use a phrase search, it appears to only search the text within the topic.
I don't understand how the use of <indexterm> element is used by search at all.

My scoring.properties has the following

Code: Select all


# Meta keyword and indexterm
meta_keywords = 100
meta_indexterms = 100
so I would expect topics with the words 'task scheduler' as an index term to be in the top results but it is not the case.
Instead topics with the 2 words task and scheduler in their heading and text (1 time) are appearing at the top of the results.
It doesn't make sense to me.
Any feedback appreciated,
Regards,
Ann

Re: Keyword versus indexterm

Posted: Fri Nov 02, 2018 12:49 pm
by radu_pisoi
Hi,

Sorry for the late reply.

I think I can reproduce the issue you have reported. In case when your search query contains multiple keywords, the WebHelp search function promote topics that contain all keywords in topic's content. The issue is that this does not happen when search keywords are specified as indexterms or keywords.

Thank you for reporting this issue.