TextEncoding Property (XMLports)

Specifies the text encoding format to use when you use an XMLport to export or import data as text.

Note

The TextEncoding property is only available when the Format Property (XMLports) of the XMLport is set to Fixed Text or Variable Text.

Values

• MS-DOS (default)


• UTF-8


• UTF-16


• Windows

Remarks

Text encoding is the process of transforming bytes of data into readable characters for users of a system or program. There are several industry text encoding formats and different systems support different formats. Internally, Microsoft Dynamics NAV uses Unicode encoding. For exporting and importing data with an XMLport, Microsoft Dynamics NAV supports MS-DOS, UTF-8, UTF-16, and Windows encoding formats.

You should set the TextEncoding property to the encoding format that is compatible with the system or program that you will be exporting to or importing from. The following sections describe the available text encoding formats.

Tip

You can also set the TextEncoding property in C/AL code. For example, if your XMLport can import or export different formats based on certain conditions, you can change the encoding on the fly depending on the conditions. For example, you can write code such as the following:

currXMLport.TEXTENCODING := TEXTENCODING::Windows;

Example

The following code example illustrates how you can set the encoding during run time.



Above screenshot is from XMLport 1220 in the CRONUS International Ltd. demonstration database.

Sample Code:

...

      CASE MyDefinitionTable."File Encoding" OF

MyDefinitionTable."File Encoding"::"MS-DOS":

currXMLport.TEXTENCODING(TEXTENCODING::MSDos);

MyDefinitionTable."File Encoding"::"UTF-8":

currXMLport.TEXTENCODING(TEXTENCODING::UTF8);

MyDefinitionTable."File Encoding"::"UTF-16":

currXMLport.TEXTENCODING(TEXTENCODING::UTF16);

MyDefinitionTable."File Encoding"::WINDOWS:

currXMLport.TEXTENCODING(TEXTENCODING::Windows);

...

The table, MyDefinitionTable, (Imaginary Table) has a field, File Encoding, (imaginary Field) that specifies the encoding for this part of an import.