# tXSLT

Ce composant transforme une structure de données en une autre structure.

Ce composant tient compte d'une feuille de style XSL pour transformer un fichier source XML et l'envoyer vers la sortie définie.

## Propriétés du tXSLT Standard

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

Le composant tXSLT Standard appartient à la famille XML.

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

## Basic settings

| Propriétés | Description |
| --- | --- |
| XML file/stream | Chemin d'accès au fichier XML ou au flux de données à valider. Dans le cas d'un flux, les données doivent être ajoutées au flux pour que le composant récupère les données via la variable correspondante.<br><br>Le flux de données à traiter doit être ajouté au flux afin que ce composant récupère ces données via la variable représentative correspondante.<br><br>Cette variable peut être prédéfinie dans le Studio Talend, ou fournie par le contexte ou les composants que vous utilisez avec ce composant. Sinon, vous pouvez la définir manuellement et l'utiliser en fonction de la conception du Job, par exemple avec un tJava ou un tJavaFlex.<br><br>Afin d'éviter les désagréments de la saisie, vous pouvez sélectionner la variable qui vous intéresse dans la liste d'autocomplétion (Ctrl+Espace) afin de remplir le champ, si cette variable a été correctement définie.<br><br>Pour plus d'informations concernant l'utilisation d'un flux (stream), consultez [Lire les données d'un fichier distant en mode stream](https://help.qlik.com/talend/fr-FR/components/8.0/delimited/tfileinputdelimited-tfilefetch-tsleep-tlogrow-reading-data-from-remote-file-in-streaming-mode-standard-component-this).<br><br>Note InformationsRemarque : Ce champ n'est pas disponible si vous sélectionnez l'option Use column instead of file/stream for XML. |
| XSL file/stream | Chemin d'accès au fichier de transformation XSL de référence ou au flux de données de transformation. Dans le cas d'un flux, les données doivent être ajoutées au flux pour que le composant récupère les données via la variable correspondante.<br><br>Le flux de données à traiter doit être ajouté au flux afin que ce composant récupère ces données via la variable représentative correspondante.<br><br>Cette variable peut être prédéfinie dans le Studio Talend, ou fournie par le contexte ou les composants que vous utilisez avec ce composant. Sinon, vous pouvez la définir manuellement et l'utiliser en fonction de la conception du Job, par exemple avec un tJava ou un tJavaFlex.<br><br>Afin d'éviter les désagréments de la saisie, vous pouvez sélectionner la variable qui vous intéresse dans la liste d'autocomplétion (Ctrl+Espace) afin de remplir le champ, si cette variable a été correctement définie.<br><br>Pour plus d'informations concernant l'utilisation d'un flux (stream), consultez [Lire les données d'un fichier distant en mode stream](https://help.qlik.com/talend/fr-FR/components/8.0/delimited/tfileinputdelimited-tfilefetch-tsleep-tlogrow-reading-data-from-remote-file-in-streaming-mode-standard-component-this).<br><br>Note InformationsRemarque : Ce champ n'est pas disponible si vous sélectionnez l'option Use column instead of file/stream for XSL. |
| Output file | Chemin d'accès du fichier de sortie. Si le fichier n'existe pas, il sera créé. Le fichier de sortie peut être n'importe quel fichier structuré ou non tels que html, xml, txt ou même pdf ou edifact en fonction de votre fichier xsl.<br><br>Note InformationsRemarque : Ce champ n'est pas disponible si vous sélectionnez l'option Use column instead of File for Result. |
| Parameters | Cliquez sur le bouton [+] pour ajouter de nouvelles lignes à la liste Parameters et définir les paramètres de transformation du fichier XSLT. Pour chaque ligne, renseignez la clé dans la colonne *name* et sa valeur associée dans la colonne *value*. |
| Use column instead of file/stream for XML | Sélectionnez cette option pour utiliser les données d'une colonnes spécifiée comme entrée. Vous devez spécifier la colonne à laquelle passer les données d'entrée, dans la liste déroulante Input column for XML. |
| Use column instead of file/stream for XSL | Sélectionnez cette option pour utiliser les données d'une colonnes spécifiée comme XSL. Vous devez spécifier la colonne à laquelle passer les données XSL, dans la liste déroulante Input column for XSL. |
| Use column instead of File for Result | Sélectionnez cette option pour écrire en sortie les données transformées dans une colonne spécifiée. Vous devez spécifier la colonne à laquelle passer les données transformées, dans la liste déroulante Input column for result. |
| Schema et Edit Schema | Un schéma est une description de lignes, il définit le nombre de champ qui sont traités et passés au composant suivant. Le schéma est soit local (Built-in), soit distant dans le Repository.<br><br><ul> <li> <span>Built-in</span>&nbsp;: le schéma est créé et conservé pour ce composant uniquement. 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>.</li> <li> <span>Repository</span>&nbsp;: 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>.</li> </ul><br><br>Ce composant offre la fonction de schéma dynamique. Cela vous permet de récupérer des colonnes inconnues de fichiers sources ou de copier des lots de colonnes d'une source sans avoir à mapper chaque colonne individuellement. Pour plus d'informations concernant les schémas dynamiques, consultez [Schéma dynamique](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/dynamic-schema).<br><br>Cette fonctionnalité de schéma dynamique est conçue pour permettre de récupérer des colonnes inconnues d'une table. Il est recommandé de l'utiliser uniquement à cet effet et non pour créer des tables.<br><br>Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :<br><br><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> |
| 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 lorsqu'un lien Row connecte le composant de sortie. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStatCatcher Statistics | Cochez cette case pour collecter les métadonnées de traitement 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>OUTPUT\_FILEPATH : chemin d'accès au fichier de sortie. Cette variable est une variable Flow et retourne une chaîne de caractères.<br><br>OUTPUT\_FILENAME : nom du fichier de sortie. Cette variable est une variable Flow et retourne une chaîne de caractères.<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 standalone. |
| Limitation | Du fait d'une incompatibilité de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans l'onglet Component. Vous pouvez également trouver les JAR manquants et les ajouter dans l'onglet Modules de la perspective Integration de votre Studio Talend. Pour plus d'informations, consultez la page [Installation de modules externes](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/installing-external-modules). |

**Concepts associés**

* [Transformer un flux en HTML à l'aide d'une feuille de style XSL](https://help.qlik.com/talend/fr-FR/components/8.0/xml/transforming-stream-to-html-using-xsl-stylesheet-standard-component "Le composant tXSLT fournit le support des flux. Il peut recevoir des fichiers XML ou XSL qui lui sont transférés sous forme de flux. En plus d'envoyer la sortie vers des fichiers, il peut également envoyer la sortie au composant suivant, via un lien Row > Main. Le composant tXSLT dans ce scénario reçoit le fichier XML d'un composant tFileInputRaw, sous forme de flux et envoie sa sortie à un tLogRow via une colonne prédéfinie.")
* [Transformer un XML en HTML à l'aide d'une feuille de style XSL](https://help.qlik.com/talend/fr-FR/components/8.0/xml/txslt-tmsgbox-transforming-xml-to-html-using-xsl-stylesheet-standard-component "Ce scénario décrit un Job à deux composants appliquant une feuille de style XSL à un fichier XML et génère un fichier HTML en sortie. Il permet également de définir un paramètre de transformation pour la feuille de style XSL afin de changer la couleur de l'arrière-plan de l'en-tête dans le document HTML créé en sortie.")