The AL developer preview is still evolving with frequent updates. Follow us on the Dynamics NAV Team Blog for the announcements.

TextEncoding Property (XMLports)

Specifies the File Handling and Text Encoding format to use when you use an XMLport to export or import data as text.

Applies to



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



File Handling and Text Encoding is the process of transforming bytes of data into readable characters for users of a system or program. There are several industry File Handling and Text Encoding formats and different systems support different formats. Internally, Dynamics 365 for Finance and Operations, Business edition uses Unicode encoding. For exporting and importing data with an XMLport, Dynamics 365 for Finance and Operations, Business edition 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 File Handling and Text Encoding formats.


You can also set the TextEncoding property in 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:



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

      CASE MyDefinitionTable."File Encoding" OF  
        MyDefinitionTable."File Encoding"::"MS-DOS":  
        MyDefinitionTable."File Encoding"::"UTF-8":  
        MyDefinitionTable."File Encoding"::"UTF-16":  
        MyDefinitionTable."File Encoding"::WINDOWS:  

The code example is based on XMLport 1220 in the CRONUS International Ltd. demonstration database. The table, MyDefinitionTable, has a field, File Encoding, that specifies the encoding for this part of an import.

See Also

XMLports Properties
Format Property (XMLports)
[File Handling and Text Encoding