dsmiley commented on code in PR #1154: URL: https://github.com/apache/solr/pull/1154#discussion_r1014960224
########## solr/solr-ref-guide/modules/query-guide/pages/query-elevation-component.adoc: ########## @@ -234,5 +234,18 @@ http://localhost:8983/solr/techproducts/elevate?q=ipod&df=text&elevateIds=IW-02, === The fq Parameter with Elevation -Query elevation respects the standard filter query (`fq`) parameter. +By default, query elevation respects the standard filter query (`fq`) parameter. That is, if the query contains the `fq` parameter, all results will be within that filter even if `elevate.xml` adds other documents to the result set. + +If you want elevated documents to be included in the result set whether or not they match specific filter queries, you can tag those filter queries using xref:local-params.adoc[LocalParams syntax] and then specify the tags for exclusion via the `elevate.excludeTags` request parameter. +Both the `tag` local param and the `elevate.excludeTags` request parameter may specify multiple values by separating them with commas. + +[source,text] +q=mainquery&fq=status:public&fq={!tag=dt}doctype:pdf&elevate.excludeTags=dt + +[source,text] +q=mainquery&fq=status:public&fq={!tag=t1,t2}a:b&fq={!tag=t3}c:d&fq={!tag=t4}e:f&elevate.excludeTags=t1,t4 + +When a filter is tagged for exclusion, it is not ignored completely; rather it is modified so that the elevated documents can pass through. +Documents that are not elevated are still subject to the filter. +This feature may have a performance impact when filter caching is enabled and the modified filters are not found in the cache. Review Comment: Definitely too low level detail. The use of the FilterQuery (itself an internal detail) will cause the cache usage to be the same as the user expects. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
