July 30, 2023

tChangeFileEncoding – Docs for ESB 7.x


Transforms the character encoding of a given file and generates a new file with the
transformed character encoding.

changes the encoding of a given file.

tChangeFileEncoding Standard properties

These properties are used to configure tChangeFileEncoding running in the Standard Job framework.

The Standard
tChangeFileEncoding component belongs to the Data Quality and the File families.

The component in this framework is available in all Talend

Basic settings

Use Custom Input Encoding

Select this check box to customize input encoding type. When it is
selected, a list of input encoding types appears, allowing you to
select an input encoding type or specify an input encoding type by
selecting CUSTOM.


From this list of character encoding types, you can select one of
the offered options or customize the character encoding by selecting
CUSTOM and specifying a
character encoding type.

Input File Name

Path of the input file.

Output File Name

Path of the output file.

Advanced settings

Create directory if does not exist

This check box is selected by default. It creates a directory to hold the
output table if required.

tStatCatcher Statistics

Select this check box to collect log data at the component level.

Global Variables

Global Variables

EXISTS: the result of whether a specified file exists.
This is a Flow variable and it returns a boolean.

FILENAME: the name of the file processed. This is an
After variable and it returns a string.

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.


Usage rule

This component can be used as standalone component.

Transforming the character encoding of a file

This Java scenario describes a very simple Job that transforms the character encoding
of a text file and generates a new file with the new character encoding.


  1. Drop a tChangeFileEncoding component onto the
    design workspace.


  2. Double-click the tChangeFileEncoding
    component to display its Basic settings view.


  3. Select Use Custom Input Encoding check box.
    Set the Encoding type to GB2312.
  4. In the Input File Name field, enter the file
    path or browse to the input file.
  5. In the Output File Name field, enter the file
    path or browse to the output file.
  6. Select CUSTOM from the second Encoding list and enter UTF-16
    in the text field.
  7. Press F6 to execute the Job.



The encoding type of the file in.txt is transformed and
out.txt is generated with the UTF-16 encoding type.

Document get from Talend https://help.talend.com
Thank you for watching.
Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x