The standard query results object consists of an answer element and its children. Most of the answer recapitulates information about the original query and its settings. The actual search results are contained in answer/response elements.

answer

The answer element is the root response element for a standard query request. See the Standard Query XML section for attributes that refer back to the query.

Attribute

Description

contentID

ContentID of index.

QUID

Value of the query’s QUID attribute.

type

Value of the query’s type attribute.

sorting

Value of the query’s sorting attribute.

sortPropt

For grouping by property, the type, name, and default value.

docSetSort

Value of the query’s docSetSort attribute.

mode

Value of the query’s mode attribute.

strategy

Value of the query’s strategy attribute.

debug

Value of the query’s debug attribute.

refineMax

Value of the query’s refineMax attribute.

refineMin

Value of the query’s refineMin attribute.

refineTop

Value of the query’s refineTop attribute.

autospell

Value of the query’s autospell attribute.

highlight

Value of the query’s highlight attribute.

minScore

Value of the query’s minScore attribute.

pageNum

Value of the query’s pageNum attribute.

pageSize

Value of the query’s pageSize attribute.

docSort

Value of the query’s docSort attribute.

docSortProp

Value of the query’s docSortProps attribute.

docSortPropDefault

Value of the query’s docSortPropDefault attribute.

docSortOrder

Value of the query’s docSortOrder attribute.

relQuestSettings

Value of the query’s relQuestSettings attribute.

responseNumberSettings

Value of the query’s responseNumberSettings attribute.

topicSettings

Reserved for future use.

responseCount

Total number of results returned.

groupCount

Total number of groups returned.

paCount

Total number of preferred answers returned. Not used in Search 2007.3.

sentenceCount

Total number of unstructured results returned.

responseScore

Relevancy score of the top result.

paScore

Relevancy score of top preferred answer result.

sentenceScore

Relevancy score of top unstructured result.

docCand

Number of document candidates considered during retrieval.

docMax

Estimate of how many documents are retrievable using the current query.

docMin

Minimum number of documents that could be returned, if all query terms were in the same documents.

ansCand

Number of sentence candidates considered during retrieval.

ansMax

Estimate of how many sentences are retrievable with the current query.

ansMin

Minimum number of sentences that could be considered, if all query terms were in the same sentence.

anspool

Number of sentence results before grouping and paging.

Child Elements

Description

question

User search string after processing and modifications. No child elements.

priorInput

Prior or secondary user input. No child elements.

userquestion

Raw user search string, unmodified. No child elements.

info

Miscellaneous information. No child elements.

documentSets

Document constraint expression. See Constraint Expressions.

prefAnswerConstr

Preferred answer constraint expression. See Constraint Expressions.

weightedProps

Document preference expression. See Constraint Expressions.

categories

Query categorization results. Contains categories child elements.

debug

Debugging information. No child elements.

queryTerms

Advanced query term vector data. Contains term child elements.

spelling

Spelling suggestions and feedback. Contains term child elements.

parserOptions

Natural language processing options. The children of this element contain detailed information about document parsing options; see the ATG Search Administration Guide.

queryRule

Query analysis rule results. Contains an operation child element. See query rules in the ATG Search Administration Guide.

queryAction

Action arguments. Contains a rule child element. See query rules in the ATG Search Administration Guide.

response

A single search result. See the answer/response section in this chapter.

responseTree

Categorization of the results. Contains a responseGroup child element, which is the document set of returned results.

feedbackReport

Query feedback data. Contains relatedSetenceTerms, relatedPhraseTerms, and relatedDocumentSets child elements.

refinements

Query refinement data. Contains child elements representing different data types for refinement.

answer/response

A single search result.

Attributes

Description

score

Relevancy score of the result. See the Relevancy Calculation section in the Query Concepts and Processes chapter.

id

Result index in this response.

answerGroup

Result group identifier.

type

Type of result.

viewable

Whether or not the document or preferred answer is viewable.

segment

The ACA segment identifier.

field

The text field name.

sortprop

Value of the grouping property. See Result Groups in this chapter.

Child Elements

Description

text

Matching statement text of the result. No child elements.

norm

Normalized statement text. No child elements.

faq

Question text for preferred answer results. No child elements.

document

Document of the result. See the answer/response/document section of this chapter.

debug

Debugging information. No child elements.

answer/response/document

A single document within the response element.

Attributes

Description

contextID

View context information in the form:

hdoc:start-final,start-final….

hdoc

Document identifier.

goto

Jump to off-set of this result in the document text.

size

Size of source of document.

docset

Physical document set of the document.

type

Major format of document.

lang

Language of document.

filename

File name (excluding path).

relevance

Relevance score of document.

Child Elements

Description

title

Title of document. No child elements.

summary

Summary of the document. No child elements.

_url

URL of the document. No child elements.

timestamp

Last modified date/time of document. No child elements.

question

Question text if the document is a preferred answer. No child elements.

answer

Answer text if the document is a preferred answer. No child elements.

properties

List of meta-data properties for this document, contained by simple meta child elements.

documentSets

List of related document sets or categories, contained by simple set child elements.

Constraint Expressions

When present in a query’s result XML, a constraint expression contains any constraint information that has been applied to the query, including:

See the Query Constraints section of the Query Component Reference chapter for more information. Constraints can also be configured using metadata or query rules; see the ATG Search Administration Guide for information.

 
loading table of contents...