Reader Directives

The suffixes shown are prefixed by the current <ReaderKeyword> in a mapping file. By default, the <ReaderKeyword> for the Textline reader is TEXTLINE.

DATASET

The value for this directive is the name of a single Text file. The usual extensions for text files are .txt and .txt.gz.

Required/Optional

Required

Mapping File Syntax

TEXTLINE_DATASET “C:\DATA\TEXT\myfile.txt”

Workbench Parameter

Source Text File(s)

GROUP_BY_DATASET

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

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. The default value for this directive is No.

Values

Yes | No

Required/Optional

Required

Mapping File Syntax

GROUP_BY_DATASET "Yes"

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 READ_WHOLE_FILE_AT_ONCE is set to Yes.

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.

This method preserves the exact contents of the file including line separators, EOF markers, etc.

Required/Optional

Optional

Workbench Parameter

Read Whole File at Once

SKIP_LINES

Required/Optional: Optional

This field can be listed to indicate 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 is useful if the file contains a header line of field names or other descriptive material that should be skipped.

Values: <number>

Workbench Parameter: Number of Lines to Skip

SKIP_FOOTER

This field can be listed to indicate 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 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. If reading backwards, the lines are skipped from the top of the file instead.

Required/Optional

Optional

Values

<number>

Workbench Parameter

Number of Footer Lines to Skip

ENCODING

This optional specification controls which character encoding is used when reading the input file.

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 that only the UTF encodings are stored by the format in the form of a 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 encoding.

Required/Optional

Optional

Values

<encoding>

Workbench Parameter

Character 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