Thunderstone Search Appliance Manual

XML Elements in Search Results

Search results can be sent as XML from the Parametric Search Appliance to the host server. This section describes the XML elements.

<ThunderstoneResults> Overall container for the search results

• <XmlOutputVersion> Defines the version of this xml output

• <ResultsFromCache> Set to Y if this is from results caching

• <Query> Main text search string

• <TitleQuery> Query applied only to titles

• <UrlQuery> Query applied to URL

• <DepthQuery> Maximum Depth

• <MimeTypeQuery> Query applied to Mime Type

• <CategoryQuery> Numeric index for a category to use. 1 is the first category, etc.

• <RequireAllCategories> Set to Y if results must be in ALL specified CategoryQuery instead of "one or more."

• <ResultsPerSiteQuery> Max results per site

• <TextQuery> Text part of main search query, sans infield: prefix. Suitable for concatenation with "infield:" and re-insertion in a new query

• <TextQueryHighlight> TextQuery with query highlighting (if enabled)

• <PreviousRefine> Additional refine queries

• <SiteQuery> Site query (from site:host in the query, or dedicated sq query string variable)

• <LinkQuery> Link query (from link:URL in the query)

• <InFieldQueriesAllowed> Set to Y if infield: queries are allowed

• <InFieldQuery> Infield queries that were executed

  Attributes:

  • @field - name of the field

  • @isInternalField - Set to Y for internal (non-Parametric) fields

  • @operator - operator used in the query

  Child elements:

  • <Query> Full query, sans infield: prefix

  • <Value> query's value alone

  • <ValueDisplay> Alternate value for displaying

  • <Tooltip> Alternate value for the tooltip

• <ModifiedDateLessThan> Only return results with Modified date earlier than this

• <ModifiedDateGreaterThan> Only return results with Modified date greater than this

• <UrlRoot> URL root of the search script, for making links

• <Profile> Profile used

• <dropXSL> Whether to apply or drop the XSL stylesheet

• <AdvancedSearch> Set to 1 if the advanced form should be displayed

• <Proximity> Proximity used for the search. Possible values:

  • line - Must occur on the same line

  • sentence - Must occur within the same sentence

  • paragraph - Must occur within the same paragraph

  • page - must occur within same HTML document (default)

• <Suffixes> Suffix processing for the search. Possible values:

  • 0 - Exact Match only

  • 1 - Plurals and Possessives

  • 2 - All Word Forms

  • 3 - Custom

• <Thesaurus> Set to 1 if the Thesaurus was used for synonyms

• <Order> Ordering of the search. Possible values:

  • r - relevance

  • dd - newest first

  • da - oldest first

• <RankOrder> Favors results with query terms in the same order as the query

• <RankProximity> Favors results with query terms close together

• <RankDatabaseFrequency> Favors results with query terms more rare across the entire profile

• <RankDocumentFrequency> Favors results with query terms repeated more often

• <RankPosition> Favors results with query terms earlier in the document

• <RankDepth> Favors results fewer links away from the starting point

• <mode> Set to admin if this is a Test Search

• <opts> Internal use only

• <authUser> User that was authenticated via the Proxy Module

• <metasearchTarget> Indicates what backend metasearch targets are available, one element for each target. Currently selected targets will have a selected="selected" attribute

• <AdminUrl> URL to the admin interface

• <MakeLiveUrl> URL to make this Look and Feel live

• <RssUrl> URL to RSS version of this search

• <OpensearchUrl> URL to the OpenSearch version of this search

• <OpensearchTitle> Suggested title for this OpenSearch

• <QueryAutocomplete> Set to Y if Query Autocomplete is enabled

• <LogoutUrl> URL for a 'Logout' link

• <ParametricQuery> Parametric SQL Query used

  • <UserQueryAllowed> Allow Override value (default N)

  • <Query> SQL Query Clause used (only shown if UserQueryAllow=Y

  • <Param> A parameter name and value for the Parametric SQL Query

• <Category> Categories available for search

  • <CatVisible> Set to Y if the category should be selectable in the list of categories

  • <CatSel> Set to Y if this category is currently selected

  • <CatVal> Numeric ID for this category

  • <CatName> Display name for this category

• <TopBestBets> List of "Best Bets" links

  • <BBTitle> Title for this section of Best Bets

  • <BestBet> Individual Best Bet records

    • <BBResultNum> Ordered number for this Best Bet

    • <BBPriority> Priority for this Best Bet, as assigned in the admin interface

    • <BBLink> URL for this Best Bet

    • <BBLinkDisplay> URL that displays for this Best Bet. Long Urls are intelligently truncated for display

    • <BBResult> URL for this individual Best Bet, as assigned in the admin interface

    • <BBDescription> Description for this individual Best Bet, as assigned in the admin interface

    • <BBGroupname> Name of the Best Bet group this Best Bet belongs to

    • <BBGroupid> id of the Best Bet group this Best Bet belongs to

    • <BBKeywords> Keywords that trigger this Best Bet record to display. This is all keywords for this individual record, not just the one that triggered this activation

• <ProfileInfo> Encloses some profile summary info

  • <Profile> Profile to which this ProfileInfo refers to

  • <ResultDecl> Declarations of User Fields that will be in Result elements, each has a name and type attribute

  • <ExitIsEarly> Set to Y if search aborted

  • <ExitReason> Set to ok if search finished normally, otherwise token indicating reason (see ExitReason table below)

  • <RedirectUrl> Only used when results Authorization Method is set to Forward login cookies. If present, specifies a (Referer-modified) version of Login URL (the search setting, not XML element). Its value is an external (not Parametric Search Appliance) URL to redirect the user to, which will prompt the user to log in and obtain the authentication cookies needed for a Results Authorization search.

  • <LoginUrl> Only used when results Authorization Method is set to Basic/NTLM/file - prompt via form. If present, specifies a local (Parametric Search Appliance) <form action> URL to submit the rauser/rapass variables to, which contain user credentials needed for a Results Authorization search.

• <Summary> Encloses search results summary, only present if a search was actually performed

  • <Profile> Profile that this Summary element applies to

  • <Start> First result item to list

  • <End> Last result item to list

  • <TotalNum> Total number of result items found, before Results Authorization

  • <TotalIsEstimate> Set to Y if TotalNum is an estimate

  • <TotalIsShort> Set to Y if TotalNum is known to be short (e.g. early exit)

  • <UserResultsNum> Total number of result items found, after Results Authorization

  • <UserResultsIsEstimate> Set to Y if UserResultsNum is an estimate

  • <UserResultsIsShort> Set to Y if UserResultsNum is an estimate

  • <ResultsAuthorization> Set to Y if Results Authorization was used

  • <Total> Readable text for total number of results, after Results Authorization

  • <GroupBySite> Set to Y if Results per Site was used with this query.

  • <CurOrder> Text that describes the order by which results are listed

  • <OrderLink> URL that provides an alternative sorting order results list

  • <OrderType> Text that describes OrderLink

  • <GroupByResults> Contains information about how the results may be grouped by a parametric field.

    Attributes:

    • @countIsEstimate - Set to Y if counts are estimated

    • @orderBy - Indicates group ordering. Possible values:

      • CountDesc - Count Descending

      • CountAsc - Count Ascending

      • FieldDesc - Field Descending

      • FieldAsc - Field Ascending

    • @maxResults - Max groups

    Child elements:

    • <Field> Name of the parametric field

    • <Group> Information about the individual groups

      • <Value> Value of the parametric field that this group represents

      • <ValueDisplay> Displayable value of this group's field

      • <Tooltip> Alternate value for the tooltip

      • <Count> Number of results that match this value

      • <UrlResults> URL to restrict the search to this value

  • <GroupByCollapsed> Info for each collapsed (not expanded) Group By

    • <Field> Name of the parametric field

    • <UrlResults> URL to expand this Group By

  • <NewSkip> (Metasearch only) Skip value to use for any further request. Only needed with the SOAP API

  • <PreviousLink> URL to the previous page of results

  • <FirstPage> Set to 1 if this is the first page of results

  • <Pages> Contains data on pages of results

    • <PageLink> URL to a certain page of results

    • <PageNumber> Page number a page of results

  • <NextLink> URL to the next page of results

  • <LastPage> Set to 1 if this is the last page of results

  • <Credit> Text to introduce the credit image

  • <CreditImage> URL of the credit image

• <Result> Contains data about a given result

  • <Profile> Profile for this Result

  • <BackendProfile> Profiles used by metasearch backends

  • <Num> Number of this result item

  • <Skip> Internal use: raw skip(s) for result. Valid for Meta Search back-ends

  • <Id> Identifier for this result

  • <ResultTitle> Title of this result

  • <Url> URL of this result

  • <ClickUrl> URL for this result item, as should be clicked by the user. Use Url if not present. Only sent if Query Logging is enabled, in which case it contains redirect for logging the click-through

  • <UrlPDFHi> URL to highlight this PDF in Acrobat Reader, only used with Legacy highlighting

  • <UrlDisplay> Displayed URL for this result

  • <UrlCached> URL to retrieve the cached version of this result

  • <RawRank> Raw relevance rank value for this result (0-1000)

  • <ScaledRank> Raw rank scaled up for a more-like-this search (0-1000)

  • <PercentRank> ScaledRank as a percentage (0-100)

  • <DocSize> Size (bytes) of this result

  • <MimeType> MimeType for this result

  • <MimeTypeIcon> Icon file to use for this MimeType

  • <Depth> Number of links walked from Base URL(s) to this URL

  • <UrlSimilar> URL to search for pages similar to this result

  • <UrlInfo> URL for context of answers within a matching document

  • <UrlParents> URL of pages that link to this search result

  • <Modified> Date and time this result was last modified

  • <Visited> Date and time this result was walked

  • <Abstract> Brief text surrounding the matched word or phrase

  • <Charset> Character set of the formatted text of the page (typically Storage Charset unless conversion failure)

  • <SiteName> Name of the site for this result item

  • <UrlMoreResultsFromSite> URL for more results from this site

  • In addition, any Parametric Fields that have been selected for Output will be sent as child elements of Result, one per field. Each element is named after the field, with a u: XML namespace prefix since they are custom fields. The value of the field will be the content of the element.

    For example, an Integer field Quantity and a GMLPoint field Location may be given as:

    <u:Quantity>57</u:Quantity>
    <u:Location>47.4500 -122.3000</u:Location>

• <RightBestBets> List of right "Best Bets" links, see TopBestBets

• <Spelling> Spelling suggestions

  • <SuggestWord> An individual spelling suggestion

    • <SpellPhrase> Label for the suggestions

    • <SpellLink> URL to search for the suggestion

    • <SpellWord> Suggestion content

    • <SpellCount> Number of results for this suggestion

• <exportVar> Additional exported variables

• <QueryMessage> Messages to show to the user

• <Message> Additional diagnostic messages

Match Info output is similar to search results, except it contains a ContextResult element instead of Result elements. ContextResult contains:

<ContextResult> Container for the "Match Info" for this result

• <Url> URL of this result

• <ClickUrl> URL for this result item, as should be clicked by the user. Use Url if not present. Only sent if Query Logging is enabled, in which case it contains redirect for logging the click-through

• <UrlDisplay> Displayed URL for this result

• <Depth> Number of links walked from Base URL(s) to this URL, with a full text label

• <Size> Size (bytes) of this result

• <MimeType> MimeType for this result

• <MimeTypeIcon> Icon file to use for this MimeType

• <Modified> Date and time this result was last modified

• <Visited> Date and time this result was walked

• <RecordCategory> Categories that would match this result

• <Title> Title of this result

• <Description> Description of the result

• <Keywords> Keywords of the result

• <Meta> Extracted metadata of the result

• <Body> Body text the result

• In addition, any Parametric Fields that have been selected for Output will be sent as child elements of Result, one per field. Each element is named after the field, with a u: XML namespace prefix since they are custom fields. The value of the field will be the content of the element.

  For example, an Integer field Quantity and a GMLPoint field Location may be given as:

  <u:Quantity>57</u:Quantity>
  <u:Location>47.4500 -122.3000</u:Location>