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