Links
dtSearch Text Retrieval Engine Programmer's Reference
ISearchReportJob Interface
dten600.idl | Interfaces | Legend | Members | Methods | Properties | Send Feedback
Class Hierarchy
[ object, uuid(697DF028-B24E-11D3-B57C-00105AA461D0), dual, helpstring("ISearchReportJob Interface"), pointer_default(unique) ]
interface ISearchReportJob : IDispatch;
File
Description

Use a SearchReportJob to generate a search report from some or all of the items listed in a SearchResults object.

Remarks

To create a SearchReportJob,

  1. Call the SearchResults object's NewSearchReportJob method (see ISearchResults),
  2. Set up the properties of the SearchReportJob to reflect the format of the report you want to create, and
  3. Call the Execute method of the SearchReportJob to create the report.

For sample code, see frmMakeReport in the vbsearch sample application.

Format

A search report lists the hits found in one or more documents, with each hit surrounded by a specified amount of context. Each block of context starts with a contextHeader and ends with the contextFooter. Contiguous or overlapping blocks of context will be combined. The amount of context included in the report can be specified by words or by paragraphs. 

Each block of context is constructed as follows:

    [ContextHeader]
    ...text... [BeforeHit] hit [AfterHit] ...text...
    [ContextFooter]

 

The report as a whole is constructed as follows:

    [Header]
        [FileHeader]
            [ContextHeader]
            ...text... [BeforeHit] hit [AfterHit] ...text...
            [ContextFooter]
            [ContextHeader]
            ...text... [BeforeHit] hit [AfterHit] ...text...
            [ContextFooter]
            ... more blocks of context, if present
        [FileFooter]
        ... more files ...
    [Footer]

 

Use the following symbols to insert file information into the FileHeader and FileFooter:

Symbol 
Meaning 
Filename 
The name of the file (without path information). For PDF and HTML files, this will be the Title. 
Location 
The location of the file 
Fullname 
The path and filename of the file. 
Size 
File size in bytes 
Date 
Modification date of the file when indexed 
Hits 
Number of hits in the file 
Title 
The first 80 characters of the file 

Use the following symbols to insert context information in the contextHeader, which appears in front of each block of context:

Symbol 
Meaning 
Page 
Page number where the hit occurs 
Paragraph 
Paragraph number where the hit occurs (relative to the start of the page) 
Word 
Word offset of the block of context from the beginning of the file. 
FirstHit 
Word offset of the first hit in this block of context. 

Use %% around each symbol, like this: %%FullName%%

Group
Methods
Method 
Description 
Clear all selections, so no items from search results will be selected to be included in the report 
Generate the report 
Select all items from search results to include in the report 
Select a range of items in the SearchResults 
Properties
Property 
Description 
Text to be inserted after each hit 
Text to be inserted before each hit 
Text to appear after each block of context 
Text to appear after each file in the search report. 
A JobErrorInfo (IJobErrorInfo) containing information about any errors that occurred during generation of the search report. 
Text to appear after each file in the report 
Text to appear in front of each file in the search report. 
ReportFlags specifying how the report should be generated 
Text to be inserted at the end of the report 
Text to be inserted at the top of the report 
Number of blocks of context to include in the report. If zero, all hits in each document will be included. 
Number of words to scan in each document looking for blocks of context to include in the report. 
The name of the file to create. 
Output format for the conversion (see OutputFormats enum for a list of types). By default, a FileConverter converts the input file to HTML. Other supported options are: it_RTF (212), it_Utf8 (238) (Unicode text), and it_Ansi (202). 
If OutputToString is true, output will be stored in OutputString rather than in a disk file. 
If OutputToString is true, the maximum size of the string to create in OutputString 
If true, output will be stored in OutputString instead of in a file 
Paragraphs of context to include around each hit 
Maximum number of seconds to allow the job to run 
Number of words or paragraphs of context to include surrounding each hit. If WordsOfContextExact is set, exactly the requested number of words of context will be included. Otherwise, enough paragraphs of context will be included to provide at least the requested number of words. 
Number of words or paragraphs of context to include surrounding each hit. If WordsOfContextExact is set, exactly the requested number of words of context will be included. Otherwise, enough paragraphs of context will be included to provide at least the requested number of words. 
Legend
 
Property 
 
read only 
 
Method 
Links
You are here: COM Interface > Interfaces > ISearchReportJob Interface
Copyright (c) 1995-2008 dtSearch Corp. All rights reserved.