# tXMLMap

Ce composant transforme et route des données à partir d'une ou plusieurs source(s) de données vers une ou plusieurs destination(s).

Le tXMLMap est un composant avancé personnalisable permettant de transformer et de router des flux de données XML (données de type document), particulièrement pour traiter de nombreuses sources de données XML, avec ou sans jointure sur les données plates.

## Propriétés du tXMLMap Standard

Ces propriétés sont utilisées pour configurer le tXMLMap s'exécutant dans le framework de Jobs Standard.

Le composant tXMLMap Standard appartient aux familles Processus en cours et XML.

Le composant de ce framework est disponible dans tous les produits Talend.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Map Editor | Le Map Editor vous permet de définir les propriétés du routage et des transformations du tXMLMap. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStatCatcher Statistics | Cochez cette case pour collecter les métadonnées de traitement du Job, aussi bien au niveau du Job qu'au niveau de chaque composant. |
| Keep order for document | Cochez cette case pour écrire en sortie les éléments XML dans l'ordre spécifié dans le schéma XML de sortie. |

## Variables globales

| Variables | Description |
| --- | --- |
| Variables globales | ERROR\_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.<br><br>Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.<br><br>Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.<br><br>Pour plus d'informations concernant les variables, consultez [Utiliser les contextes et les variables](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/contexts-and-variables). |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| **Règle d'utilisation** | Plusieurs utilisations sont possibles, de la simple réorganisation des champs de données aux transformations les plus complexes, telles que le multiplexage et le démultiplexage de données, la concaténation, l'inversion, le filtrage, etc.<br><br>Lorsque c'est nécessaire, vous pouvez définir vos sorties pour les flux XML, à l'aide de l'élément "group", de l'élément "aggregate", d'éléments vides et de toute autre fonctionnalité, comme All in one. Pour plus d'informations concernant ces fonctionnalités, consultez [Définir le mode de sortie](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/defining-output-mode).<br><br>Ce composant est utilisé comme composant intermédiaire et correspond parfaitement au processus nécessitant de nombreuses sources de données XML, comme les processus ESB de requête/réponse. |
| Limitation | Les limites sont les suivantes :<br><br>- L'utilisation du composant tXMLMap requiert des connaissances minimales en Java et XML afin d'exploiter au mieux ses fonctionnalités.<br><br>Il ne peut donc être ni un composant d'entrée, ni un composant de sortie.<br><br>- Au moins un élément répétable est requis pour chaque flux de données XML. |

Les sections suivantes présentent plusieurs scénarios génériques d'utilisation du composant tXMLMap. Si vous souhaitez consulter des exemples spécifiques d'utilisation de ce composant avec les composants ESB afin de construire des services de données, consultez les scénarios des composants ESB :

* [Effectuer une requête sur des noms d'aéroport à partir des codes pays](https://help.qlik.com/talend/fr-FR/components/8.0/esb-soap/tesbconsumer-tesbproviderfault-tmap-requesting-airport-names-based-on-country-codes-standard-component-esb-this)

* [Envoyer d'un message via un service sans attente de réponse](https://help.qlik.com/talend/fr-FR/components/8.0/esb-soap/tesbconsumer-tesbproviderrequest-tlogrow-tfixedflowinput-sending-message-without-expecting-response-standard-component-esb-the)

* [Retourner une réponse &quot;Hello world&quot;](https://help.qlik.com/talend/fr-FR/components/8.0/esb-soap/tesbconsumer-tesbproviderrequest-tfixedflowinput-returning-hello-world-response-standard-component-esb-the)

**Concepts associés**

* [Mapper et transformer des données de source XML](https://help.qlik.com/talend/fr-FR/components/8.0/txmlmap/txmlmap-tfileinputxml-tlogrow-tlogrow-mapping-and-transforming-xml-data-standard-component-the "Le scénario suivant crée un Job à trois composants pour mapper et transformer des données provenant d'un fichier source XML, Customer.xml et générer un flux de sortie XML pouvant être réutilisé dans différents buts, comme, par exemple, pour une requête ESB basée sur la structure de l'arbre XML du fichier Customer_State.xml.")
* [Restructurer des données produit à l'aide de différents éléments répétables](https://help.qlik.com/talend/fr-FR/components/8.0/txmlmap/txmlmap-tfileinputxml-tlogrow-tfileoutputxml-restructuring-products-data-using-multiple-loop-elements-standard-component-the "Ce scénario utilise un Job à quatre composants pour restructurer les données produit fournies par un fichier XML source, ProductsIn.xml à l'aide de différents éléments répétables (loop element) et écrivant la sortie dans un fichier XML ProductsOut.xml.")