ISYS.CFG Format

In the ISYS.CFG file, which directs the Update process, each entry is on a separate line. Keywords are followed by at least one space. Blank lines and lines with an asterisk '*' as the first character are ignored. Each line is an entry, which may be a configuration definition or an indexing rule. The ISYS.CFG file may be encoded in either ANSI or UTF8 Unicode.

Within the ISYS.CFG file, each indexing rule applies to the document area identifier they follow. There may be more than one indexing rule for each document area identifier.

An indexing rule consists of three parts:

Format keyword

Document area identifiers

Folder and file pattern

Additional Optional processing instructions can be added to the Folder and file patterns

The format keyword identifies the format in which the documents are stored, or that the documents should not be indexed. The file and directory specification pattern gives a directory and file pattern that documents must match. The optional processing indicates any additional requirements.

When comparing a document with the indexing rules, Perceptive Search works in the order in which the rules have been presented. The first configuration rule under the appropriate document area identifier that matches the file specification is the rule used for the document.

A list of ISYS.CFG keywords in included at the bottom for reference.

ISYS.CFG syntax

Sample of a segment of an ISYS.CFG:

Version 9
NAME My Documents Index

FORMATS ASCII HTMLRAW MSG EXCEL RTF WINWORD PDF POWERPOINT WINWRITE WordPerfect
FORMATS EML

SIGNIFICANT 0123456789ŠŒšœŸÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿINSIGNIFICANT '/_`‘Concurrent
DateRecognition
SummaryIndexing
FileNameIndexing
MetaTitles
SpellingTips
CacheMetaData

UNDER C:\
  AUTO            "DOCUMENTS AND SETTINGS\ISYSUSER\MY DOCUMENTS\**\*.*"

Format keywords

In the ISYS.CFG file, file formats included in the index are specified by Format keywords. These are:

See the list of Perceptive Search supported File Types for more information on these file formats.

Document area identifier

In the ISYS.CFG file, the document area identifier tells Perceptive Search to which drive the indexing rules apply. You cannot specify a directory with the document area identifier; it must be specified in the indexing rules.

An example of a document identifier is UNDER F:\

There may be zero or more document area identifiers in the ISYS.CFG file; these can be a drive letter or the word "NETWORK". If there is no identifier or the identifier UNDER HERE is used, Perceptive Search assumes the directory in which the ISYS.CFG file is located is the only directory to be indexed.

The order in which the document area identifiers are specified is unimportant. However, the indexing rules that specify which documents and directories to index or ignore must follow the document area identifier to which they apply.

Where the document area identifier is "UNDER NETWORK" the directory patterns make use of UNC's to unmapped network shares.

File and folder specification pattern

In the ISYS.CFG file, the file specification is a pattern used to determine whether the format applies to any given file. The DOS wild card characters ("*" and "?") may be used in the file name.

FolderName\FileName.ext

Include or exclude just this folder and file pattern

FolderName\**\FileName.ext

Include or exclude documents matching the file pattern in and under this folder

FolderName\*\FileName.ext

Include or exclude documents matching this file pattern under, but not in, this folder.

FolderName\*\temp\*\FileName.ext

Include or exclude all matching files in the sub-folders called temp under the FolderName folder.

Optional processing keywords for file and folder patterns

The following are keywords that may appear in the ISYS.CFG file under particular circumstances:

Examples:

    ASCII *.TXT HARDSPACE

This indicates everything in the current directory that has an extension of *.TXT is to be indexed as an ASCII text document and all lines in the documents end with a hard return.

UNDER F:\
    BYPASS  REVENUE\**\DRAFT*.*
    EXCEL   REVENUE\**\*.XLS
    AUTO    REVENUE\**\*.*

Exclude all files that have a name starting with DRAFT under the REVENUE folder and all sub-folders; index all files with an XLS extension as Excel documents; all remaining file in the REVENUE folders are to index using AUTO logic with the specified file format.

UNDER F:\
    XML REVENUE\*\**\ANNSUMM.XML IDENT 2 TITLE_FIELD FINCODE

All ANNSUMM.XML files under, but not in, the REVENUE sub-folder of F drive should be indexed as XML record file, where the level 2 layer is used to identify new records and the FINCODE value should be used as the record title.

ISYS.CFG Keywords

The following keywords may be used in the ISYS.CFG file: