SearchReportJob Class

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

public class SearchReportJob;

File

SearchReportJob.java

Remarks

To create a SearchReportJob,

1. Call the SearchResults object's newSearchReportJob method to create a SearchReportJob.

2. Set up the properties of the SearchReportJob to reflect the format of the report you want to create.

3. Call selectAll() or selectItems() to select the items to include in the report.

4. Call execute() to generate the report.

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]
            [ContextSeparator]
            [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 %% around each symbol, like this: %%FullName%%

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.

Group

Classes

Methods

Method	Description
clear	Free memory allocated for objects such as SearchResults.
clearSelections	Select no items from the SearchResults list
execute	Generate the search report.
getErrors	A JobErrorInfo containing information about any errors that occurred during generation of the search report.
getOutputString	Result of the search report, if OutputToString was set to true
selectAll	Select all items in the SearchResults list
selectItems	Select a range of items from the SearchResults list
setAfterHit	Text to insert after each hit.
setBeforeHit	Text to insert before each hit.
setContextFooter	Text to appear after each block of context.
setContextHeader	Text to appear in front of each block of context.
setContextSeparator	Text to appear between each block of context.
setDocBytes	Use setDocBytes to provide a document in a memory buffer rather than as a disk file.
setFileFooter	Text to appear after each file in the search report.
setFileHeader	Text to appear in front of each file in the search report.
setFlags	SearchReportFlags specifying how the report should be generated
setFooter	Footer of the search report
setHeader	Header of the search report
setMaxContextBlocks	Number of blocks of context to include in the report.
setMaxWordsToRead	Number of words to scan in each document looking for blocks of context to include in the report.
setOutputFile	The name of the file to create.
setOutputFormat	The file format of the output.
setOutputStringMaxSize	When output is directed to an in-memory string, you may wish to limit the maximum amount of memory used.
setOutputToString	If true, output will be stored in an in-memory string variable rather than a disk file.
setParagraphsOfContext	Number of paragraphs of context to include around each hit.
setResults	The search results list that this SearchReportJob will use.
setTimeoutSeconds	Set to a non-zero value if you want the job to terminate automatically after a specified number of seconds.
setWordsOfContext	Number of words of context to include around each hit.
setWordsOfContextExact	Number of words of context to include around each hit.

Legend

Method

Links

Classes, Legend, Members, Methods