Version

    DBFDataReader

    Short Description
    Ports
    Metadata
    DBFDataReader Attributes
    Details
    See also

    Short Description

    DBFDataReader reads data from fixed-length dbase files. It can also read data from remote locations, compressed files, input port, or dictionary.

    ComponentData sourceInput portsOutput portsEach to all outputsDifferent to different outputsTransformationTransf. req.JavaCTLAuto-propagated metadata
    DBFDataReaderdBase file0-11-n
    yes
    no
    no
    no
    no
    no
    no

    Ports

    Port typeNumberRequiredDescriptionMetadata
    Input0
    no
    		For port reading. See Reading from Input Port.One field (byte, cbyte, string).
    Output0
    yes
    		For correct data recordsAny
    1-n
    no
    		For correct data recordsOutput 0

    Metadata

    DBFDataReader does not propagate metadata.

    DBFDataReader does not have any metadata template.

    Metadata on output ports can use Autofilling Functions.

    source_timestamp and source_size functions work only when reading from a file directly. If the file is an archive or it is stored in a remote location, timestamp will be empty and size will be 0.

    It can read only fixed length data records.

    DBFDataReader Attributes

    AttributeReqDescriptionPossible values
    Basic
    File URLyes

    The attribute specifying what data source(s) will be read (dbase file, input port, dictionary). See Supported File URL Formats for Readers.

    		 
    Charset Encoding of records that are read.IBM850 (default) | <other encodings>
    Data policy 

    Determines what should be done when an error occurs. For more information, see Data Policy.

    		Strict (default) | Controlled[1 ]| Lenient
    Advanced
    Number of skipped records 

    The number of records to be skipped continuously throughout all source files. See Selecting Input Records.

    		0-N
    Max number of records 

    The maximum number of records to be read continuously throughout all source files. See Selecting Input Records.

    		0-N
    Number of skipped records per source 

    The number of records to be skipped from each source file. See Selecting Input Records.

    		Same as in Metadata (default) | 0-N
    Max number of records per source 

    The maximum number of records to be read from each source file. See Selecting Input Records.

    		0-N
    Incremental file[2 ]

    The name of the file storing the incremental key, including the path. See Incremental Reading.

    		 
    Incremental key[2 ]

    The variable storing the position of the last read record. See Incremental Reading.

    		 

    [1 ] Controlled data policy in DBFDataReader does not send error records to the edge. Errors are written into the log.

    [2 ]  Either both or neither of these attributes must be specified.

    Details

    DBFDataReader can be used to read UTF-8 encoded dBase files. Metadata extraction wizard is able to extract metadata from such file (preview works well and respects selected charset).

    In general, DBFDataReader can use any encoding for parsing. Note that every character at any column name (stored at header of the file) must be represented by a single byte. Example: set UTF-8 encoding. It is possible to read Japanese characters stored at dBase file but the column name must not contain such a character. Just single byte characters are used for the column name so that some charsets cannot be used (for example UTF-16).

    Notes and Limitations

    The metadata used for writing data with DBFDataWriter is different from metadata required by DBFDataReader. If you read data from .dbf files, you need an extra metadata field called delete flag.