Search Parameters

The possible parameters that can be used in the query string are:

Queries:

  • category - Category to limit results to, specified by name. Can be provided multiple times, or as pipe- ("|") separated values list, to limit results to those with any of the specified categories. Added in version 20.1. See Categories, here.

  • requireAllCategories - Setting to Y requires each result to be in all specified categories, instead of any one of them. Added in version 20.1. See Categories, here.

  • cq - Category to limit results to, specified by number: cq=1 for first category, cq=2 for second, etc. Can be provided multiple times or as a CSV to limit results to those with any of the specified categories. See Categories, here. Deprecated; use category instead.

  • cqall - Setting to Y requires each result to be in all specified categories, instead of any one of them. See Categories, here. Deprecated; use requireAllCategories instead.

  • dq - Maximum Depth query (e.g. dq=2 for results found at most 2 links away from Base URLs)

  • mtq - Mime Type query. May be an exact literal (e.g. mtq=application/pdf) or have a * after the / for anything of the left type (e.g. mtq=text/*)

  • query - Main search query

  • sq - Site query (here)

  • tq - Title-only query (same Metamorph syntax as keyword search)

  • uq - URL query, match against the entire URL. Accepts wildcards * for any amount of anything and ? for any single character. (e.g. uq=https://www.example.com/dir/*)

Search control:

  • dateSource - What date to use, id or Modified (see below)

  • mdgt - Modified Date Greater Than: Only results with a modified date less than this will be returned.

  • mdlt - Modified Date Less Than: Only results with a modified date less than this will be returned.

  • pr - Specifies the Search Appliance profile

  • prox - Proximity: Only return results with the query words in the same line, sentence, paragraph, or page (default). Sets the Proximity search option (here).

  • order - Controls the sort order; this is the same variable that Result Order (here) controls. Valid values are r (relevance), dd (date descending: newest first), or da (date ascending: oldest first). The date used for newest/oldest sorting is the Last-Modified date of the document (or date of walk if none); this can be changed via the dateSource parameter (here). In version 17.1 and later, rank may be given as an alias for r (relevance), date for dd (newest first), and size, visited or depth may also be given. order may also be an Additional Field to sort by; see Sorting under Additional Fields, here.

  • rpp - Max number of results per page (up to permitted limit; see Max User Results Per Page search setting, here)

  • sr - Max number of results per site (if permitted; see Results per Site search settings, here)

  • sufs - Word forms (suffixes). Values are 0 (Exact match), 1 (Plurals & Possessives), 2 (Any word forms), or 3 (Custom)

  • mu - For meta searches: each value is a target profile (display name) to search. Can be used to narrow down target profile search list. Only respected if User Selection (here) is Y.

Rank Knobs: control the influence of ranking factors. Unless otherwise specified, each is an integer value, from off (0) to maximum (1000), to indicate the relative weight of that factor. Medium (500) is the default.

  • rorder - Word ordering: Favors results with query terms in the same order as the query; overrides Word Ordering (here)

  • rprox - Word proximity: Favors results with query terms close together; overrides Word Proximity (here)

  • rdfreq Database frequency: Favors results with query terms more rare across the entire profile; overrides Database Frequency (here)

  • rwfreq - Document frequency: Favors results with query terms repeated more often in the document; overrides Document Frequency (here)

  • rlead - Position in text: Favors results with query terms earlier in the document; overrides Position in Text (here)

  • rdepth - Depth in site: "Shallower" results (fewer clicks from the Base URL) are better; overrides Depth in Site (here)

  • rdatebiasWeight - Date bias weight: Favors "newer" results (closer to rdatebiasAnchor i.e. now). Additional parameters:

    • rdatebiasHalfLife - Date bias decay rate: time for rdatebiasWeight to be halved, in seconds

    • rdatebiasAnchor - Date bias reference point: "best" date for maximum rank; can be lastWalkFinished for completion date of last successful walk, or Texis-parseable date

    • rdatebiasField - Date bias field: date field to use for computing document age (default Modified)

    All of these override the equivalent Date Bias value in Search Settings (here).

Additional Fields: To add search restrictions to the query you can specify form variables with a name constructed as afnOP, where n is the number of the additional field (1, 2, or 3), and OP is one of the following operations:

  • eq - the field is equal to the form variable (e.g. af1eq)

  • gt - the field is greater than the form variable (e.g. af2gt)

  • gte - the field is greater or equal to than the form variable

  • lt - the field is less than the form variable

  • lte - the field is less or equal to than the form variable

  • like - the field matches the form variable (text search). This has the same syntax and functionality of the Metamorph query engine used in the main text search.

Examples:

  • af1eq=important - only results where the first additional field is set to important

  • af2lt=100 - only results where the 2nd additional field is less than 100.

  • af3gte=2010-01-01 - only results where the 3rd additional field is 2010 or newer.

  • af1like=important - only results where the first additional field contains the word important

  • af1like=(critical,important) - only results where the first additional field contains either important or critical

dateSource: id vs modified

The dateSource parameter allows you to determine which date associated with the URL gets used for display, sorting, etc.

  • Modified (default) - The time the content was last modified

  • id - The time that Search Appliance last updated its record of the content
If a collection of files that were modified a year ago were picked up by the Search Appliance walk last night, then the Modified date would be a year ago, but the id date would be last night.

id is the default dateSource when requesting an RSS feed of a search.

Other Variables

  • dropXSL - When Results Style (here) is set to XSL Stylesheet, or the search request URL is search/main.xml (note the .xml extension), the dropXSL query variable controls how the XSL is applied. It may have one of the following values:

    • html - Apply the XSL style sheet server-side and serve the resulting HTML

    • no - Do not apply XSL, nor give an XSL reference. Browsers will display the raw XML. Can be useful for debugging/analyzing XML results.

    • yes - Do not apply the XSL, but give an XSL reference so that browsers will fetch and apply the XSL client-side.
    If not given, dropXSL is set based on the search/main.ext file extension in the URL: no if .xml was given, html otherwise.

Copyright © Thunderstone Software     Last updated: Nov 8 2024
Copyright © 2024 Thunderstone Software LLC. All rights reserved.