Writer Directives

The directives listed below are processed by the Dale File writer. The suffixes shown are prefixed by the current <WriterKeyword> in a mapping file. By default, the <WriterKeyword> for the Data File writer is DATAFILE.

DATASET

The value for this directive is a data file (*.*)

Required/Optional

Required

Workbench Parameter

Destination Data 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: 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 and if unset will default to system.

Values

Windows| UNIX | Macintosh | Source | None

Required/Optional

Optional

Workbench Parameter

Line Termination

WRITE_LAST_EOL

Specifies whether the final line in the file should be terminated with an End of Line (EOL) character appropriate to the END_OF_LINE directive.

Required/Optional

Optional

Values

YES (Default) | NO

Workbench Parameter

YES (Default) | NO

ENCODING

This optional specification controls which character encoding is used when writing the output file.

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: 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.

If writing binary files it is recommended that the special BINARY encoding be used to ensure that the raw bytes are written in all cases.

Values

<encoding>

Encodings

UTF-8

UTF-16LE
UTF-16BE
ANSI
BINARY
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 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