cMap Standard properties

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

The Standard cMap component belongs to the Transformation family.

The component in this framework is available in Talend Data Management Platform, Talend Big Data Platform, Talend Real-Time Big Data Platform, Talend Data Services Platform, and in Talend Data Fabric.

Basic settings

Open Map Editor	Click the [...] button to open the Structure Generate/Select wizard. You can first select the type of map to create: Standard Map: Map that perform mappings using functions based on xQuery Availability-noteBeta DSQL Map: Map that performs mappings using Data Shaping Query Language. You can select the Don't ask me again check box to save this preference. For more information about these map types, see Working with maps. Information noteNote: This option is available only if you have installed the R2023-10 Studio monthly update or a later one delivered by Talend. For more information, check with your administrator. Then you can either have the hierarchical mapper structure generated automatically based on the schema, or select an existing hierarchical mapper structure. You must do this for both the input and output sides of your Map. The following lists the options for the output structure: Generate hierarchical mapper structure based on the schema option: When you connect multiple output connections to the tHMap, the page displays a confirmation message that informs you that the mapper structures are generated based on the output connections. Select an existing hierarchical mapper structure option: You can connect multiple outputs that are payload-based connections to the tHMap. If there is a single payload-type connection, you can select the Allow support for multiple output connections check box. The generated output map inherits from the existing payload structure. If Talend Studio detects multiple output connections available, the window displays both output structure options without the support for multiple output connections check boxes. If neither input nor output connection exists, the Structure Selection page is displayed.
Map Path	Specifies the map to be executed. Click the [...] button next to the Map Path field to open a dialog box in which you can select the map you want to use, then click the [...] button next to Open Map Editor to work with the map selected. Note that this map must have previously been created in the Mapping perspective.
Output Type	From the drop-down list, select how you want the output to be written. Default: The default output is the same as the input, or Java if the map outputs Java. String: Use this option if the data in the output column is to be a String. Byte Array: Use this option if the data in the output column is to be a Byte array. InputStream: Use this option if you are working with Talend Data Mapper metadata and the input is a stream. Object: Use this option to produce a collection of Avro GenericRecord objects.

Open Map Editor

Click the [...] button to open the Structure Generate/Select wizard.

You can first select the type of map to create:

Standard Map: Map that perform mappings using functions based on xQuery
Availability-noteBeta
DSQL Map: Map that performs mappings using Data Shaping Query Language.

You can select the Don't ask me again check box to save this preference. For more information about these map types, see Working with maps.

Note: This option is available only if you have installed the R2023-10 Studio monthly update or a later one delivered by Talend. For more information, check with your administrator.

Then you can either have the hierarchical mapper structure generated automatically based on the schema, or select an existing hierarchical mapper structure. You must do this for both the input and output sides of your Map. The following lists the options for the output structure:

Generate hierarchical mapper structure based on the schema option: When you connect multiple output connections to the tHMap, the page displays a confirmation message that informs you that the mapper structures are generated based on the output connections.
Select an existing hierarchical mapper structure option: You can connect multiple outputs that are payload-based connections to the tHMap. If there is a single payload-type connection, you can select the Allow support for multiple output connections check box. The generated output map inherits from the existing payload structure.

If Talend Studio detects multiple output connections available, the window displays both output structure options without the support for multiple output connections check boxes.

If neither input nor output connection exists, the Structure Selection page is displayed.

Map Path

Specifies the map to be executed.

Click the [...] button next to the Map Path field to open a dialog box in which you can select the map you want to use, then click the [...] button next to Open Map Editor to work with the map selected. Note that this map must have previously been created in the Mapping perspective.

Output Type

From the drop-down list, select how you want the output to be written.

Default: The default output is the same as the input, or Java if the map outputs Java.
String: Use this option if the data in the output column is to be a String.
Byte Array: Use this option if the data in the output column is to be a Byte array.
InputStream: Use this option if you are working with Talend Data Mapper metadata and the input is a stream.
Object: Use this option to produce a collection of Avro GenericRecord objects.

Advanced settings

Use old Eclipse runtime (deprecated)	Select this check box to include the old Eclipse runtime in your Route. Information noteNote: This option is available only if you have installed the R2024-03 Talend Studio monthly update or a later one delivered by Talend. For more information, check with your administrator.
Exception Threshold	Talend Data Mapper returns an execution status with an severity value which can be OK, Info, Warning, Error or Fatal. By setting the exception threshold, you can specify the severity level at which an exception is thrown, thus enabling downstream components to detect the error in cases other than the default value of Fatal. From the drop-down list, select the severity level at which an exception may be thrown during the execution of a map. Fatal (default): An exception is thrown when a fatal error occurs. Error: An exception is thrown when an error (or higher) occurs. Warning: An exception is thrown when a warning (or higher) occurs.

Use old Eclipse runtime (deprecated)

Select this check box to include the old Eclipse runtime in your Route.

Note: This option is available only if you have installed the R2024-03 Talend Studio monthly update or a later one delivered by Talend. For more information, check with your administrator.

Exception Threshold

Talend Data Mapper returns an execution status with an severity value which can be OK, Info, Warning, Error or Fatal. By setting the exception threshold, you can specify the severity level at which an exception is thrown, thus enabling downstream components to detect the error in cases other than the default value of Fatal.

From the drop-down list, select the severity level at which an exception may be thrown during the execution of a map.

Fatal (default): An exception is thrown when a fatal error occurs.
Error: An exception is thrown when an error (or higher) occurs.
Warning: An exception is thrown when a warning (or higher) occurs.

Usage

Usage rule	cMap is used for Routes that require data mapping.
Limitation	Due to license incompatibility, one or more JARs required to use this component are not provided. You can install the missing JARs for this particular component by clicking the Install button on the Component tab view. You can also find out and add all missing JARs easily on the Modules tab in the Integration perspective of Talend Studio. For details, see Installing external modules. This limitation applies to maps that reference databases.

Usage rule

cMap is used for Routes that require data mapping.

Limitation

Due to license incompatibility, one or more JARs required to use this component are not provided. You can install the missing JARs for this particular component by clicking the Install button on the Component tab view. You can also find out and add all missing JARs easily on the Modules tab in the Integration perspective of Talend Studio. For details, see Installing external modules.

This limitation applies to maps that reference databases.

Note:

For further information about performing transformations using Talend Data Mapper , see Talend Data Mapper User Guide.
When using representations other than Map, CSV, Avro, XML, and Cobol, running this component with the old Eclipse-based Runtime may create temporary folders, which are not automatically removed after stopping the Runtime. If you frequently run Talend Data Mapper, these files may pile up and eventually lead to a disk full error. When the error occurs, the runtime fails. To avoid this, ensure that you perform periodical cleaning. For more information, see Cleaning up temporary folders and files.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here