Propriétés du tFileInputRegex Standard

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

Le composant tFileInputRegex Standard appartient à la famille Fichier.

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.
File name/Stream	File name : nom du fichier, et/ou variable à traiter. Avertissement : Utilisez un chemin absolu (au lieu d'un chemin relatif) dans ce champ pour éviter des erreurs. Stream : flux de données à traiter. Les données doivent préalablement être ajoutées au flux afin d'être récupérées par le tFileInputRegex via la variable INPUT_STREAM disponible dans la liste d'auto-complétion (Ctrl+Espace). Pour plus d'informations concernant l'utilisation et la définition de variables dans un Job, consultez le Guide d'utilisation du Studio Talend.
Row separator	Saisissez le séparateur utilisé pour identifier la fin d'une ligne.
Regex	Saisissez votre expression régulière Java, y compris le sous-modèle correspondant aux champs à extraire. Ce champ peut contenir plusieurs lignes. Note : vous devez doubler les barres obliques inversées (Antislash) en regexp. Avertissement : L'expression régulière doit être saisie entre guillemets doubles. Pour extraire toutes les chaînes de caractères souhaitées, assurez-vous que l'expression régulière contient les sous-modèles correspondant aux chaînes de caractères. Chaque sous-modèle de l'expression régulière doit être entouré de crochets.
Header	Saisissez le nombre de lignes à ignorer au début du fichier.
Footer	Nombre de lignes à ignorer en fin de fichier.
Limit	Nombre maximum de lignes à traiter. Si Limit = 0, aucune ligne n'est lue ou traitée.
Ignore error message for the unmatched record	Cochez cette case afin de ne pas écrire en sortie les messages d'erreur pour les enregistrements qui ne correspondent pas à l'expression régulière définie. Cette case est cochée par défaut.
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. Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles : 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.
	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 Jobs et projets.
Skip empty rows	Cochez cette case pour ignorer les lignes vides.
Die on error	Cochez cette case pour arrêter l'exécution du Job lorsqu'une erreur survient. Décochez la case pour ignorer les lignes en erreur et terminer le traitement des lignes sans erreur. Lorsque les erreurs sont ignorées, vous pouvez récupérer les lignes en erreur en utilisant la connexion Row > Reject.

Advanced settings

Encoding	Sélectionnez l'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. Les encodages supportés dépendent de la JVM que vous utilisez. Pour plus d'informations, consultez https://docs.oracle.com. Pour afficher cette liste dans la version Map/Reduce du tFileInputRegex, vous devez cocher la case Custom encoding.
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.

Encoding

Sélectionnez l'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. Les encodages supportés dépendent de la JVM que vous utilisez. Pour plus d'informations, consultez https://docs.oracle.com.

Pour afficher cette liste dans la version Map/Reduce du tFileInputRegex, vous devez cocher la case Custom encoding.

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 globales	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. 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.

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.

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 sert à lire un fichier et à en séparer les champs selon les Regex définies. Vous pouvez aussi créer un flux de rejet avec un lien Row > Reject pour filtrer les données dont le type ne correspond pas au type défini. Pour un exemple d'utilisation de ces deux liens, consultez Procédure.