Propriétés du tFileInputJSON Standard - 7.0

JSON

EnrichVersion
7.0
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
EnrichPlatform
Studio Talend
task
Création et développement > Systèmes tiers > Composants File (Intégration) > Composants JSON
Gouvernance de données > Systèmes tiers > Composants File (Intégration) > Composants JSON
Qualité et préparation de données > Systèmes tiers > Composants File (Intégration) > Composants JSON

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

Le composant tFileInputJSON Standard appartient aux familles Internet et File.

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

Basic settings

Property Type

Peut être Built-In ou Repository.

 

Built-In : aucune propriété n'est stockée de manière centrale.

 

Repository : Sélectionnez le fichier dans lequel sont stockées les propriétés du composant.

Schema et Edit schema

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é line lors du nommage des champs.

  • Built-in : le schéma est créé et conservé localement pour ce composant seulement.

  • Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Job Designs et projets.

Créez le schéma en cliquant sur le bouton Edit Schema. Notez que si vous effectuez des modifications, le schéma passe automatiquement en type built-in.

  • View schema : sélectionnez cette option afin de voir uniquement le schéma.

  • Change to built-in property : sélectionnez cette option pour passer le schéma en mode Built-In et effectuer des modifications locales.

  • Update repository connection : 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. Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur No et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre [Repository Content].

Read By

Sélectionnez un moyen d'extraire les données JSON du fichier.

  • JsonPath : extrait les données JSON en se basant sur la requête JSONPath. Lorsque cette option est sélectionnée, vous devez sélectionner une version de l'API JSONPath dans la liste API version. Il est recommandé de lire les données via JSONPath afin d'améliorer les performances.

  • Xpath : extrait les données JSON en se basant sur la requête XPath.

  • JsonPath without loop : extrait les données JSON en se basant sur la requête JSONPath sans configurer de nœud de boucle.

Use Url

Cochez cette case pour récupérer les données directement à partir d'internet.

URL

Saisissez le chemin de l'URL d'où vous souhaitez récupérer les données.

Ce champ est disponible uniquement lorsque la case Use Url est cochée.

Filename

Spécifiez le fichier duquel récupérer les données.

Ce champ n'est pas disponible lorsque la case Use Url est cochée.

Avertissement : Utilisez un chemin absolu (au lieu d'un chemin relatif) dans ce champ pour éviter des erreurs.

Loop Jsonpath query

Spécifiez le nœud JSONPath sur lequel se base la boucle.

Si vous avez sélectionné Xpath dans la liste déroulante Read by, le champ Loop Xpath query s'affiche.

Mapping

Renseignez cette table pour mapper les colonnes définies dans le schéma aux nœuds JSON correspondants.

  • Column : les cellules Column sont automatiquement renseignées avec le nom des colonnes définies dans le schéma.

  • Json query/JSONPath query : spécifie le nœud JSONPath contenant les données souhaitées. Pour plus d'informations concernant les expressions JSONPath, consultez http://goessner.net/articles/JsonPath/ (en anglais).

    Cette colonne est disponible uniquement lorsque l'option JsonPath est sélectionnée dans la liste Read By.

  • XPath query : spécifie le nœud XPath contenant les données souhaitées.

    Cette colonne est disponible uniquement lorsque l'option Xpath est sélectionnée dans la liste Read By.

  • Get Nodes : cochez cette case pour extraire les données JSON de tous les nœuds ou cochez la case à côté d'un nœud spécifique pour en extraire les données.

    Cette colonne est disponible uniquement lorsque l'option Xpath est sélectionnée dans la liste Read By.

Die on error

Cochez cette case pour arrêter l'exécution du Job lorsqu'une erreur survient. Décochez-la pour ignorer les lignes en erreur et terminer le processus avec les lignes sans erreur. Si nécessaire, vous pouvez récupérer les lignes en erreur en utilisant un lien de type Row > Reject.

Advanced settings

Advanced separator (for number)

Cochez cette option pour modifier les séparateurs utilisés pour les nombres. Par défaut, le séparateur des milliers est une virgule (,) et le séparateur décimal est un point (.).

Thousands separator : définissez le séparateur utilisé pour les milliers.

Decimal separator : définissez le séparateur utilisé pour les décimaux.

Use the loop node as root

Cochez cette case pour utiliser le nœud de boucle comme racine pour interroger le fichier.

Le nœud de boucle est configuré dans le bloc de texte Loop Json query de la vue Basic Settings. Si cette option est cochée, seuls les éléments enfants du nœud de boucle sont disponibles pour la requête. Sinon, les éléments enfants ainsi que les éléments parents du nœud de boucle peuvent être interrogés. Vous pouvez spécifier un élément parent via la syntaxe de chemin JSON.

Cette case est disponible uniquement lorsque JsonPath est sélectionné dans la liste déroulante Read By de la vue Basic Settings.

Validate date

Cochez cette case pour vérifier strictement le format de date par rapport au schéma d'entrée.

Cette case n'est disponible que si la case Read By XPath est cochée.

Encoding

Sélectionnez le type d'encodage à partir de la liste ou sélectionnez Custom et définissez-le manuellement. Ce champ doit obligatoirement être renseigné.

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

Global Variables

NB_LINE : nombre de lignes traitées. Cette variable est une variable After et retourne un entier.

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.

Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.

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.

Pour plus d'informations concernant les variables, consultez le Guide d'utilisation du Studio Talend .

Utilisation

Règle d'utilisation

Ce composant est composant de début d'un Job et requiert toujours un lien de sortie.