# tBarChart

Ce composant génère un diagramme en barres à partir des données d'entrée afin de faciliter l'analyse technique.

Le composant tBarChart lit des données à partir d'un flux d'entrée et transforme les données en diagramme en barres dans un fichier image au format PNG.

## Propriétés du tBarChart Standard

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

Le composant tBarChart Standard appartient à la famille Business Intelligence.

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

## Basic settings

| Propriétés | Description |
| --- | --- |
| Schema et Edit schema | <ul> <li> <p>Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) à traiter et à passer au composant suivant. Lorsque vous créez un Job Spark, évitez le mot réservé <kbd>line</kbd> lors du nommage des champs.</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> <div><span>Note Informations</span><span>Remarque :</span> <p>Le schéma du <span>tBarChart</span> contient trois colonnes en lecture seule nommées respectivement <span>series</span> (type String), <span>category</span> (type String), et <span>value</span> (type Integer), selon un ordre prédéterminé. 									Les données de toutes les autres colonnes seront simplement passées au composant suivant, s'il y en a un, mais elles ne seront pas présentes dans le diagramme en barres.</p> </div> </li> <li> <p> <span>Built-in</span>&nbsp;: 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</span>&nbsp;: le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé. 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 lorsqu'une connexion de type Row est connectée au composant de sortie. |
| Generated image path | Nom et chemin d'accès du fichier image de sortie. |
| Chart title | Saisissez le titre du diagramme en barres à générer. |
| Include legend | Cochez cette case si vous souhaitez inclure une légende à votre diagramme en barres, afin d'afficher toutes les séries (series) dans des couleurs différentes. |
| 3Dimensions | Cochez cette case afin de créer une image en trois dimensions. Par défaut, cette case est cochée et les barres représentant les séries (series) de chaque catégorie (category) sont empilées les unes sur les autres. Si cette case est décochée, une image en deux dimensions est créée, et les barres s'affichent les unes à côté des autres le long de l'axe category. |
| Image width et Image height | Saisissez la largeur et la hauteur du fichier image, exprimées en pixels. |
| Category axis name et Value axis name | Saisissez le nom de l'axe category et le nom de l'axe value. |
| Foreground alpha | Saisissez un entier entre *0* et *100* afin de définir la transparence de l'image. Plus ce nombre est petit, plus votre image sera transparente. |
| Plot orientation | Choisissez l'orientation qu'aura votre diagramme en barres : VERTICAL ou HORIZONTAL. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStat Catcher Statistics | Cochez cette case afin de collecter les données au niveau du composant. |
| Enable parallel execution | Cocher cette case permet de traiter plusieurs flux de données simultanément. Notez que cette fonctionnalité dépend de la capacité de la base de données ou de l'application à gérer plusieurs insertions en parallèle ainsi que le nombre de processeurs utilisés. Dans le champ Number of parallel executions, vous pouvez :<br><br><ul> <li>Saisir le nombre d'exécutions parallèles désirées.</li> <li>Appuyer sur les touches <span>Ctrl+Espace</span> et sélectionner la variable de contexte appropriée dans la liste. Pour plus d'informations concernant les variables de contexte, consultez <a href="https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/contexts-and-variables" target="_blank">Utiliser les contextes et les variables</a>. </li> </ul><br><br><ul><li> 						            Le champ <span>Action on table</span> n'est pas disponible avec la fonction de parallélisation. Ainsi, pour créer une table, vous devez utiliser un composant <span>tCreateTable</span>.  </li><li> 						            Lorsque l'exécution parallèle est activée, il n'est pas possible d'utiliser les variables globales pour retrouver les valeurs de retour dans un sous-Job. </li> </ul> |

## Variables globales

| Variables | Description |
| --- | --- |
| Variables globales | 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>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** | Ce composant est principalement un composant de sortie. Par conséquent, il requiert un composant d'entrée ainsi qu'une connexion de type Row Main. |

**Concepts associés**

* [Créer un diagramme en barres à partir de données d'entrée](https://help.qlik.com/talend/fr-FR/components/8.0/chart/tbarchart-tmap-tfileoutputdelimited-tpostjob-creating-bar-chart-from-input-data-standard-component-this)