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