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 |