project help search

Description

Search the default help index and any [project]-help groups in this or ancestor projects and automatically add the following filter ({group} can be a group or project).

psodcumenttype:help

Please note, the API of this class is not stable yet. Some parameter names may change, the XML output may also change slightly in future releases.

Select the index

The current implementation of PageSeeder produces one Lucene index per group. The index is selected by the group on the request. If there is a project on the request all the groups under the project that the member has access to will be selected. For a project the groups parameter can be used to narrow the groups selected. It must be a comma-separated list of group names.

The query

The query can be of two types: predicate or question. The parameter type specifies that type.

The parameters used for a predicate query are predicate and defaultfield. The predicate specified ust be parseable by the Lucene classic parser. See http://lucene.apache.org/core/5_2_1/queryparser/org/apache/lucene/queryparser/classic/package-summary.html for more info.

The parameters for a question query are question and questionfields which will form the main predicate for the search.

The question is typically one or multiple terms, separated with spaces, and may also come directly from the user.

Each term in the question will be converted into Lucene Term s for each field specified in the fields parameters. The fields parameter would typically include the title ( pstitle) and content ( pscontent ) for a full text search. The fields should be indexed by Lucene; and it is preferable that they are analyzed. In order to generate extracts, they must be stored.

For a question type, the Lucene query produced will be the equivalent of:

+(field1:term1 field1:term2 field2:term1 field2:term2 ...)

Using filters

The filters parameter is a comma-separated list of Lucene index terms including the field name: [field]:[term] .

For example, the filters parameter value psauthor:john,pspriority:high will only display results by author 'john' and have priority 'high'.

When filtering, the Lucene query produced will be the equivalent of:

+facet1:value1 +facet2:value2 ...)

Ranges

The ranges parameter can be used to filter using a set of ranges. It is a comma-separated list of range searches with format:

field:[|{(lower)?;(upper)?}|]

where [ or ] means include limit value and { or } means exclude limit value. For example:

ranges=psproperty-expires:[2015-03-20;2016-01-01],psproperty-title:[A;C} ranges=psxrefcount:{50;],psreversexrefcount:[;10]

Organising search results

Results can be paged and ordered.

The page and pagesize controls which part of the search results will be returned. They must be positive integer values and will default to 1 and 100 respectively.

The sortfields parameter is a comma-separated list of fields to sort the results; the results are sorted by relevance if no sortfields parameter is specified.

Parameters

Permission

The user must be logged in and results will only be returned from projects where they are a member of a group.

Response

The XML response is:

<search>
  <query> ... </query>
  <suggestions> ... </suggestions>
  <facets> ... </facets>
  <results>  ... </results>
</search>

For details see Service: /groups/{group}/search [GET].

Error Handling