Development > Utilities > Miscellaneous > UTFB conversion 

The Adonix engine used by the software in version 140 is UNICODE; this signifies that it is capable of managing the characters of the languages requiring a coding of more than a byte (notably the asiatic characters), and supports different coding standards.

The most common standards recognised by ADONIX are the following:

* the UTF8 standard, which consists of coding for characters using a variable number of bytes.

*  the UCS2 standard, which codes characters in 2 bytes.

In the case of ASCII characters used for European languages, the UTF8 codes ASCII characters when the code is less that 128, on a single byte, with the same ASCII code. It is thus only the accented characters that change (they are coded on 2 bytes).

This is why the ADONIX source processes are stored in UTF8 standard. A process for a version older than v140, stored in ASCII, can still be read by the editor; if it is re-written, it is automatically rewritten in UTF8. When this happens, an indicator in the process header makes possible to know if it is v130 or v140 source code.

It can nevertheless be useful to convert a v140 process into a v130 process, and in a more general fashion to convert a text file in ASCII code, UTF8 or UCS2 into another of these formats. This is what makes possible this utlity, which presupposes one thing: that texts are organised with a maximum of 250 characters per line, with an end of line character equal to Line Feed (code 10), whether or not it is preceded by the code for Carriage Return (code 13).

Screen management

Entry screen

Presentation

On accessing the function, the following are entered, the folder, the directory, the file name and the extension of the file to be processed. The sense of the conversion is chosen and then the screen is validated.

Close

 

Fields

The following fields are present on this tab :

File to convert

Define the code for the folder in which the elements to be processed are found (as it is defined in the folders table).

  • Directory (field REP)

Define the directory in which the file to be processed is found. The sub-directories of a folder that are likely to be involved are essentially the following :

sub-directory

Contents

TRT

source of the processes

BQE, BQR, BQT

bank file

TRA

log files

TXT

certain text files

  • File (field FIC)

Define the name of the file to be processed. Warning, according the operating systems, the upper/lower case different may or may not be significant.

  • Extension (field EXT)

Extension of the file to be processed. In the case of an Adonix process, it is the extension src.

Conversion type

  • Conversion (field SNS)

The different conversion cases are defined by means of this choice.

Close

 

Other conditions

No table is updated, only the defined file on the application server has its code converted. It should be noted that a temporary file, with the same name as the file to be converted, but with the extension .utf8 is created.

Batch task

This function can be executed in batch mode, but no dedicated standard task is delivered to execute it.

Error messages

The only error messages are the generic ones.

Tables used

SEEREFERTTO Refer to documentation Implementation