tFileInputMSPositional properties - 6.1

Talend Components Reference Guide

EnrichVersion
6.1
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 Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
task
Data Governance
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

Component family

File/Input

 

Function

tFileInputMSPositional reads multiple schemas from a positional file.

Purpose

tFileInputMSPositional opens a complex multi-structured file, reads its data structures (schemas) and then uses Row links to send fields as defined in the different schemas to the next Job components.

Basic settings

Property type

Either Built-in or Repository.

Since version 5.6, both the Built-In mode and the Repository mode are available in any of the Talend solutions.

 

 

Built-in: No property data stored centrally.

 

 

Repository: Select the repository file where the properties are stored. The fields that follow are completed automatically using the data retrieved.

 

File Name

Name of the file and/or the variable to be processed

For further information about how to define and use a variable in a Job, see Talend Studio User Guide.

 

Row separator

String (ex: "\n"on Unix) to distinguish rows.

 

Header Field Position

Start-end position of the schema identifier.

 

Records

Schema: define as many schemas as needed.

Header value: value in the row that identifies a schema.

Pattern: string which represents the length of each column of the schema, separated by commas. Make sure the values defined in this field are relevant with the defined schema.

Reject incorrect row size: select the check boxes of the schemas where to reject incorrect row size.

Parent row: Select the parent row from the drop-down list. By default, it is <Empty>.

Parent key column: Type in the parent key column name. If the parent row is not <Empty>, this field must be filled with a column name of the parent row schema.

Key column: Type in the key column name.

 

Skip from header

Number of rows to be skipped in the beginning of file.

 

Skip from footer

Number of rows to be skipped at the end of the file.

 

Limit

Maximum number of rows to be processed. If Limit = 0, no row is read or processed.

 

Die on parse error

Let the component die if an parsing error occurs.

 

Die on unknown header type

Length values separated by commas, interpreted as a string between quotes. Make sure the values entered in this fields are consistent with the schema defined.

Advanced settings

Process long rows (needed for processing rows longer than 100,000 characters wide)

Select this check box to process long rows (this is necessary to process rows longer than 100 000 characters).

 

Advanced separator (for numbers)

Select this check box to modify the separators used for numbers:

Thousands separator: define separators for thousands.

Decimal separator: define separators for decimals.

 

Trim all column

Select this check box to remove leading and trailing whitespaces from defined columns.

 

Validate date

Select this check box to check the date format strictly against the input schema.

 

Encoding

Select the encoding type from the list or select Custom and define it manually. This field is compulsory for DB data handling.

 

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a Job level as well as at each component level.

Global Variables

NB_LINE: the number of rows read by an input component or transferred to an output component. This is a Flow variable and it returns an integer.

NB_LINE_REJECTED: the number of rows rejected. This is a Flow variable and it returns an integer.

NB_LINE_UNKOWN_HEADER_TYPES: the number of rows with unknown header type. This is a Flow variable and it returns an integer.

NB_LINE_PARSE_ERRORS: the number of rows with parse errors. This is a Flow variable and it returns an integer.

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl + Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio User Guide.

Usage

Use this component to read a multi schemas positional file and separate fields using a position separator value. You can also create a rejection flow using a Row > Reject link to filter the data which does not correspond to the type defined. For an example of how to use these two links, see Scenario 2: Extracting correct and erroneous data from an XML field in a delimited file.

Log4j

If you are using a subscription-based version of the Studio, the activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User Guide.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.