Writer Directives
The directives listed below are processed by the Text File writer. The suffixes shown are prefixed by the current <WriterKeyword> in a mapping file. By default, the <WriterKeyword> for the Text File writer is TEXTLINE.
DATASET
The value for this directive is a text file (*.txt), or a compressed text file. (*.txt.gz).
Required/Optional
Required
Workbench Parameter
Destination Text File
OVERWRITE_FILE
This optional directive specifies whether the output file should be overwritten or appended to. The default is for the destination file to be overwritten.
Values
YES (default) | NO
Required/Optional
Optional
Workbench Parameter
Overwrite Existing File
END_OF_LINE
Specifies the format of line terminators to be used for the output file.
Note that a value of None will cause no line terminators to be written and a value of Source will use the text_line_eol
attribute to set the line terminator which if unset will default to system.
Values
System | Windows| UNIX | Macintosh | Source | None
Required/Optional
Optional
Workbench Parameter
Line Termination
ENCODING
The default value is ANSI indicating the character encoding will be automatically detected from the system on which translation is being performed and 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 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.
Required/Optional
Optional
Values
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
MIME_TYPE (FME Server use only)
This directive is only valid for users who are authoring for FME Server's streaming service, and would like to be able to create HTML files on the fly for streaming into the browser (as opposed to streaming plain text back to the browser).
By adjusting this setting, the user is communicating to and storing in the workspace information on how the text file will be streamed back if it is used in the streaming service.
Values
The valid values for this directive include all valid MIME types. Several common types are listed and others can be entered as text strings.
Default: text/plain
Required/Optional
Optional
WRITE_UTF8_BOM
This directive specifies whether the byte order mark for any UTF-encoded file should be written at the beginning. This option applies only when the encoding is set to a UTF encoding.
Required/Optional
Optional
Values
YES (default) | NO