Reader Directives

The suffixes listed are prefixed by the current <ReaderKeyword> in a mapping file. By default, the <ReaderKeyword> for the Data File Reader is DATAFILE.

DATASET

The value for this directive is the name of a single text file (*.txt), or a compressed text file. (*.txt.gz).

Required/Optional

Required

Mapping File Syntax

DATAFILE_DATASET "C:\DATA\TEXT\myfile.txt"

Workbench Parameter

Source Data File(s)

GROUP_BY_DATASET

When the value is set to No, the only feature type this reader will use is the reader type name.

When the value is set to Yes, the feature type of each dataset is the filename (without the path or the extension) of the dataset.

Required/Optional

Required

Values

YES | NO (default)

Mapping File Syntax

GROUP_BY_DATASET “Yes”

Workbench Parameter

Feature Type Name(s)

READ_BOTTOM_UP

This optional directive specifies whether the input file should be read backwards, from the end of the file to the top. This feature is useful when only a few features from the end of a large file are required to be read.

This directive is ignored if reading the entire file at once (READ_WHOLE_FILE_AT_ONCE).

Required/Optional

Optional

Workbench Parameter

Read Bottom up

READ_WHOLE_FILE_AT_ONCE

This optional directive specifies whether the entire input file should be read into a single attribute on a single feature instead of producing a feature per line.

Required/Optional

Optional

Workbench Parameter

Read Whole File at Once

SKIP_LINES

This directive is used to set the number of lines to skip at the top of the file. By default, no lines are skipped. Each line skipped is logged to the log file. This option is useful if the file contains header lines of descriptive material that should be skipped.

This directive is ignored if reading the whole file at once (READ_WHOLE_FILE_AT_ONCE). If reading backwards (READ_BOTTOM_UP), the lines are skipped from the end of the file instead.

Values

<number>

Required/Optional

Optional

Workbench Parameter

Number of Lines to Skip

SKIP_FOOTER

This directive is used to set the number of footer lines to skip at the bottom of the file. By default, no footer lines are skipped. Each footer line skipped is logged to the log file. This option is useful if the file contains footer lines of descriptive material that should be skipped.

This directive is ignored if reading the whole file at once (READ_WHOLE_FILE_AT_ONCE). If reading backwards (READ_BOTTOM_UP), the lines are skipped from the top of the file instead.

Values

<number>

Required/Optional

Optional

Workbench Parameter

Number of Footer Lines to Skip

ENCODING

The default value is empty, indicating the character encoding will be automatically detected from the file if there is a Byte Order Marker (BOM). Otherwise all input strings will be encoded in the system encoding.

Note: Only the UTF encodings are stored by the format in the form of a Byte Order Marker (BOM), which is written optionally but by default when one of these encodings is chosen, and will be detected automatically when reading. All other character sets will need to be explicitly identified or they will be read as system.

Values

<encoding>

Encodings

UTF-8

UTF-16LE
UTF-16BE
ANSI
BIG5
SJIS
CP437
CP708
CP720
CP737
CP775
CP850
CP852
CP855
CP857
CP860
CP861
CP862
CP863
CP864
CP865
CP866
CP869
CP932
CP936
CP950
CP1250
CP1251
CP1252
CP1253
CP1254
CP1255
CP1256
CP1257
CP1258
ISO8859-1
ISO8859-2
ISO8859-3
ISO8859-4
ISO8859-5
ISO8859-6
ISO8859-7
ISO8859-8
ISO8859-9
ISO8859-13
ISO8859-15

Workbench Parameter

Character Encoding