# tWriteXMLField

Ce composant lit un fichier XML d'entrée, extrait la structure du fichier et l'insère dans les champs définis du fichier XML de sortie.

## Propriétés du tWriteXMLField Standard

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

Le composant tWriteXMLField Standard appartient à la famille XML.

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

## Basic settings

| Propriétés | Description |
| --- | --- |
| Output Column | Sélectionnez la colonne du composant de sortie dans laquelle vous souhaitez écrire la structure XML. |
| Configure XML Tree | Ouvre l'interface d'aide à la création de la structure XML à écrire dans un champ. Pour plus d'informations concernant l'interface, consultez [Définir un arbre XML](https://help.qlik.com/talend/fr-FR/components/8.0/xml-connectors/defining-xml-tree). |
| Schema et Edit Schema | <ul> <li> <p>Un schéma est une description de lignes, il définit le nombre de champs qui sont traités et passés au composant suivant. Le schéma est soit local (built-in) soit distant dans le Repository. </p> <p>Créez le schéma en cliquant sur le bouton <span>Edit Schema</span>. Si le schéma est en mode <span>Repository</span>, trois options sont disponibles&nbsp;:</p> <ul> <li> <p> <span>View schema</span>&nbsp;: sélectionnez cette option afin de voir uniquement le schéma.</p> </li> <li> <p> <span>Change to built-in property</span>&nbsp;: sélectionnez cette option pour passer le schéma en mode <span>Built-In</span> et effectuer des modifications locales.</p> </li> <li> <p> <span>Update repository connection</span>&nbsp;: sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs.</p> <p>Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur <span>No</span> et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre <span>Repository Content</span>.</p> </li> </ul> </li> <li> <p> <span>Built-in&nbsp;</span>: le schéma est créé et stocké localement pour ce composant seulement. Pour plus d'informations concernant les schémas des composants dans l'onglet <span>Basic settings (Paramètres simples)</span>, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/basic-settings-tab" target="_blank">Onglet Basic settings</a>.</p> </li> <li> <p> <span>Repository&nbsp;</span>: le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans divers projets et Jobs. Pour plus d'informations concernant les schémas des composants dans l'onglet <span>Basic settings (Paramètres simples)</span>, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/basic-settings-tab" target="_blank">Onglet Basic settings</a>.</p> </li> </ul> |
| Sync colonnes | Cliquez sur ce bouton pour synchroniser le schéma de sortie avec celui d'entrée. La fonction Sync ne s'affiche que si une connexion de type Row est liée au composant de sortie. |
| Group by | Définissez l'ensemble d'agrégation, les colonnes que vous souhaitez utiliser pour regrouper les données. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| Remove the XML declaration | Cochez cette case si vous ne souhaitez pas inclure la déclaration XML. |
| Create empty element if needed | Cette case est cochée par défaut. Si le contenu de la colonne Related Column de l'éditeur d'arborescence XML est nul, ou si aucune colonne n'est associée au nœud XML, cette option créera une balise ouvrante et une balise fermante aux endroits prévus. |
| Ignore service attributes for empty elements | Sélectionnez cette option pour empêcher le composant de générer un nœud si le nœud d'entrée est null mais contient des attributs de service (comme @type, @class et @array).<br><br>Cette option est disponible lorsque la case Create empty element if needed n'est pas cochée. |
| Expand Empty Element if needed(for dom4j) | Cochez cette case afin de permettre aux éléments null d'être affichés en tant que paires de balises, par exemple &lt;élément&gt;&lt;/élément&gt;. Sinon, ces éléments apparaissent comme des balises seule, par exemple &lt;élément/&gt;. Pour plus d'informations concernant les balises XML, consultez http://www.tizag.com/xmlTutorial/xmltag.php (en anglais).<br><br>Note InformationsRemarque : Afin d'utiliser cette option, vous devez sélectionner le mode de génération Dom4J. Cette option est disponible lorsque la case Create empty element if needed est cochée. |
| Create associated XSD file | Si l'un des éléments XML est associé à un espace de noms, cette option créera le fichier XSD correspondant.<br><br>Note InformationsRemarque : Afin d'utiliser cette option, vous devez sélectionner le mode de génération Dom4J. |
| Advanced separator (for number) | Cochez cette case pour modifier les séparateurs utilisés par défaut dans les nombres.<br><br>Thousands separator : saisissez entre guillemets le séparateur à utiliser pour les milliers.<br><br>Decimal separator : saisissez entre guillemets le séparateur à utiliser pour les décimales. |
| Generation mode | Sélectionnez le mode de génération correspondant à votre mémoire disponible. Les modes disponibles sont :<br><br><ul> <li>                         Lent et consommateur de mémoire (<span>Slow and memory-consuming - Dom4J</span>).                         <div><span>Note Informations</span><span>Remarque :</span> Cette option vous permet d'utiliser Dom4J pour traiter des fichiers XML très complexes. </div> </li> <li>                         Rapide avec peu de consommation de mémoire (<span>Fast with low memory consumption</span>)                      </li> </ul> |
| Encoding | Sélectionnez le type d'encodage à partir de la liste ou sélectionnez Custom et définissez-le manuellement. Ce champ est obligatoire pour la manipulation des données de base de données. |
| tStatCatcher Statistics | Cochez cette case pour collecter les métadonnées de traitement du Job au niveau du Job ainsi qu'au niveau de chaque composant. |

## 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>NB\_LINE : nombre de lignes lues par un composant d'entrée ou passées à un composant de sortie. Cette variable est une variable After et retourne un entier.<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** | Ce composant peut être utilisé en étape intermédiaire dans un flux de données. |

**Concepts associés**

* [Extraire la structure d'un fichier XML et l'insérer dans les champs d'une table de base de données](https://help.qlik.com/talend/fr-FR/components/8.0/xml/twritexmlfield-tfileinputxml-tmysqloutput-tmysqloutput-extracting-structure-of-xml-file-and-inserting-it-into-fields-of-database-table-standard-component "Ce scénario est composé de trois composants et permet de lire un fichier XML, d'en extraire la structure puis de transmettre cette structure dans les champs d'une table.")