# cMap

Information noteNote: This component is not shipped with your Talend Studio by default. To use it, you need to install the Data Mapper > Talend Data Mapper feature using the Feature Manager. For more information, see [Installing features using the Feature Manager](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/install-features-to-talend-studio).

Executes transformations (called maps) between different sources and destinations by harnessing the capabilities of *Talend Data Mapper* , available in the Mapping perspective.

cMap transforms data from a wide range of sources to a wide range of destinations. If you want to use multiple inputs and/or outputs, you must use *Talend Data Mapper* I/O functions. For more information, see [Input/Output expressions](https://help.qlik.com/talend/r/en-US/8.0/data-mapper-user-guide/input-output-expressions).

## 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

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

## Advanced settings

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

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | cMap is used for Routes that<br>require data mapping. |
| Limitation | Due to license incompatibility, one or more JARs required to use this component<br>are not provided. You can install the missing JARs for this particular component by<br>clicking the Install button on the Component tab view. You can also find out and add all missing<br>JARs easily on the Modules tab in the Integration perspective of Talend Studio. For<br>details, see [Installing external modules](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/installing-external-modules).<br><br>This limitation applies to maps that reference databases. |

Information noteNote:

* For further information about performing transformations using *Talend Data Mapper* , see [Talend Data Mapper User Guide](https://help.qlik.com/talend/r/en-US/8.0/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](https://help.qlik.com/talend/r/en-US/8.0/data-mapper-user-guide/cleaning-up-temporary-folders-and-files).

**Related concepts**

* [Mapping data with cMap](https://help.qlik.com/talend/en-US/mediation-components/8.0/mediation-map/cmap-cfile-mapping-data-with-cmap)